Temel noktalar
- Proxy, OpenAI chat completions formatını kullanır. İsteklerinizi OpenAI'a iletmez.
- Herhangi bir istemciyi https://api.openaiapiproxy.com/v1 adresine yönlendirin, anahtarınızı kullanın ve modeli uncensored olarak ayarlayın.
- Desteklenenler: sohbet tamamlamaları, model listesi, akış, araç çağırma ve JSON modu. Desteklenmeyenler: görseller, ses, gömme (embeddings), ince ayar (fine-tuning).
- Çoğu hata, yolda çift /v1 bulunmasından, yanlış model adından veya hız limitlerinden kaynaklanan 429 hatasından kaynaklanır.
Burada proxy kelimesinin anlamı
İnsanlar "vekil" kelimesini gevşek kullanır ve kesin olmak faydalıdır. Bu tür bir OpenAI uyumlu API vekili durumunda kelime arayüzü tanımlar: sunucu OpenAI istek yapısını kabul eder ve OpenAI yanıt yapısını döndürür. Kodunuz, protokol formatına bakarak farkı anlayamaz.
Trafikinizin OpenAI'a veya başka bir şirkete aktarıldığı anlamına gelmez. İstekler, yasal yetişkin kullanımı için içerik reddi olmadan cevap verecek şekilde ayarlanmış, bağımsız bir sağlayıcı tarafından yürütülen tek bir açık ağırlıklı modele gider. Bu, resmi OpenAI, Meta, Mistral, Qwen, DeepSeek, Google, Anthropic veya xAI API'si değildir ve satıcılar arasında seçim yapan bir yönlendirici de değildir. Bu ayrım beklentiler için önemlidir: tek bir model vardır ve model ID'si uncensored şeklindedir.
Geliştiriciler neden bir modelin önüne uyumlu bir katman koyar
OpenAI istek biçimi, LLM araçlarının ortak dili haline geldi. Kütüphaneler, editörler, ajan çerçeveleri ve kod yazmayan araçlar hepsi bunu konuşur. Uyumlu bir uç nokta, bir istemci yazmadan tüm bunları yeniden kullanmanızı sağlar.
- Yeni SDK yok. Resmi OpenAI kütüphaneleri temel URL değişikliği sonrası çalışır.
- Ücretsiz araç desteği. Özel uç nokta alanı olan her şey adaydır: sohbet arayüzleri, editör eklentileri, betikler.
- Kolay geri alma. Yeni model uygun değilse, eski URL'yi geri ayarlarsınız ve kodda başka hiçbir şey değişmez.
- Politika için tek yer. İstediğiniz model davranışını uç noktada seçin, her istekte reddetmelere karşı savaşmayın.
Bedel, uygulanan arayüzün sınırlarını kabul etmenizdir. Sonraki bölümdeki tablo tam listeyi içerir.
Ne desteklenir ve ne desteklenmez
| Özellik | Durum |
|---|---|
POST /v1/chat/completions | Destekleniyor |
GET /v1/models | Desteklenir, uncensored modelini döndürür |
| Akış (SSE) | stream: true ile desteklenir, kullanım sonu bildirilir |
| Araç çağırma | Desteklenir: tools, tool_choice, akışlı tool_calls, role: "tool" sonuçları |
| JSON modu | response_format üzerinden desteklenir |
| Örneklem parametreleri | temperature, top_p, stop, seed ve cezalar doğrudan iletilir |
| Görseller, ses, video | Mevcut değil, sadece metin |
| Gömme (Embeddings) | Mevcut değil |
| İnce ayar | Mevcut değil |
| Diğer model ID'leri | Mevcut değil, tek bir model |
Bağlam penceresi, istem ve tamamlama birlikte sayıldığında 100.000 token'dır. İstek gövdesi 8 MB olabilir. Yukarıdaki iki uç noktadan ötesine bağlı istemci kodu, örneğin bir getirme kütüphanesindeki embedding çağrısı, o çağrıda başarısız olur; bu yüzden o kısmı başka bir hizmetle birlikte tutmayı planlayın.
Beş dakikadan kısa sürede bağlanın
En hızlı yol ortam değişkenleridir. OpenAI Python ve Node SDK'ları, kodda geçirmediklerinde OPENAI_API_KEY ve OPENAI_BASE_URL değerlerini okur; bu, birçok mevcut betiğin bir satır düzenlemeden çalıştığı anlamına gelir.
export OPENAI_API_KEY="YOUR_KEY"
export OPENAI_BASE_URL="https://api.openaiapiproxy.com/v1"
curl "$OPENAI_BASE_URL/chat/completions" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'Başka sağlayıcılara da hitap eden bir kod tabanında daha güvenli olan açık yapılandırmayı tercih ederseniz, değerleri istemciye iletin:
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapiproxy.com/v1", api_key="YOUR_KEY")
for model in client.models.list():
print(model.id)
out = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarize the plot of a heist film in two sentences."}],
)
print(out.choices[0].message.content)Önce bir anahtara ihtiyacınız var. Yeni hesaplar, API anahtarı sayfası üzerinde tek tıkla $0.50 deneme kredisi talep edebilir. 7 gün için geçerlidir ve kart gerektirmez. Claude Code ile çalışıyorsanız, sitede onu Claude Code ile kullanma hakkında ayrı bir sayfa bulunmaktadır.
İstek başlıkları dışarıda da önemlidir. Her zaman Content-Type: application/json gönderin ve gövdeyi 8 MB altında tutun. Büyük bir yapıştırılmış belgeyi uzun bir sohbet geçmişiyle karıştıran bir istek, 100.000 token sınırından önce bu sınırı aşabilir; büyük metni yüklerken gövde boyutunu kontrol edin.
Herhangi bir proxy'ye güvenmeden önce beş dakikalık bir test
Seçtiğiniz uç nokta ne olursa olsun, aynı kontrolleri çalıştırın. Birkaç dakika sürer ve çoğu sürprizi kullanıcılara ulaşmadan yakalar.
- Modelleri listele. Bir
GET /v1/modelsçağrısı anahtarı ve adresi tek adımda doğrular. Buradauncensoredgörmelisiniz. - Küçük bir tamamlama gönder. Bir kelime isteyin ve
max_tokenssınırını belirleyin. Yanıt başlıklarına, özellikleX-Balance-USD'ye bakın ve makul bir miktar düştüğünü onaylayın. - Daha uzun bir yanıtı akışta gönder. Tokenların kademeli olarak geldiğini ve akışın kullanım bilgisiyle temiz bir şekilde bittiğini kontrol edin.
- Bir aracı çağır. Bir fonksiyon şeması gönder,
tool_calls'in döndüğünü kontrol et, birrole: "tool"mesajı döndür ve nihai yanıtı oku. - Bunu kasıtlı olarak boz. Tam anahtarla aynı anda dokuz istek veya deneme anahtarıyla üç istek gönderin ve
concurrencykoduyla 429 aldığınızı ve yeniden deneme kodunuzun kurtulduğunu onaylayın.
Beşinden de geçerse, entegrasyon protokol düzeyinde sağlamdır. Geriye kalan, modelin kendisini değerlendirmektir; bunu yalnızca kendi istemleriniz yapabilir.
Yaygın sorunların giderilmesi
Uyumluluk sorunları nadiren modelle ilgilidir. Neredeyse her zaman yapılandırmadan kaynaklanır. En sık karşılaşılanlar şunlardır.
Her çağrıda bulunamadı hatası
Temel URL zaten /v1 ile biter ve istemciniz /v1 ekler veya tersi. İstemci günlüğündeki son URL'yi kontrol edin. Doğru istek yolu https://api.openaiapiproxy.com/v1/chat/completions'dir.
Bir kimlik doğrulama hatası
Anahtar eksik, gereksiz bir boşluk veya yeni satır içeriyor veya yanlış başlıkta gönderildi. Format Authorization: Bearer <key> şeklindedir. Terminalden yapıştırılan anahtarlar genellikle son yeni satır içerir.
Model adı reddedilir
uncensored kullanın, küçük harfle. Bir satıcı model kimliği gibi isimler eşleşmez, çünkü burada yalnızca bir model vardır. Bazı araçlar sabit kodlanmış bir açılır liste tutar; bu durumda özel bir model adı ekleyin.
HTTP 429
Hata kodu hangi limite takıldığınızı gösterir. rate_limited, dakika başına istek sayısını aştığınızı (tam anahtarda 300, deneme sürümünde 60) belirtir. concurrency, aynı anda çok fazla istek gönderdiğinizi (tam anahtarda 8, deneme sürümünde 2) gösterir. Geçici bir aşırı yüklenme de Retry-After: 5 ile birlikte 429 hatası verir. Belirtilen süreyi bekleyin ve yeniden deneyin. Akışlı bir istek, akış bitene kadar slotunu korur; bunu unutmayın.
Maliyet, faturalandırma ve gizlilik
Fiyatlandırma, ön ödemeli krediden düşülerek 1M girdi token başına $0.15 ve 1M çıktı token başına $0.50'dir. Abonelik yoktur ve kredi süresi dolmaz. Başarısız veya reddedilen istekler için ücret alınmaz. İstemler eğitim için kullanılmaz.
Bir çalışma örneği: Destek tarzı bir araç her çağrıda 3.000 girdi token gönderir ve 400 çıktı token alır. Giriş için maliyet: 3.000 / 1.000.000 x $0.15 = $0.00045; çıkış için maliyet: 400 / 1.000.000 x $0.50 = $0.0002. Böylece bir çağrı $0.00065 tutarındadır ve 10.000 çağrı $6.50'a mal olur.
Yüklemeler $20 ile $500 arasında herhangi bir tam tutarda yapılabilir; kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile. $200'lik bir yükleme, %15 bonus içerir ve $230 kredi sağlar. Gerisi fiyatlandırma sayfasında yer almaktadır.
Uyumlu bir uç nokta seçerken dikkat edilmesi gerekenler
Bu kategori çok kalabalık olduğu için kriterlere sahip olmak faydalıdır. Hangi modeli çalıştırdığını belirtmeyen herhangi bir sağlayıcıya karşı dikkatli olun; bu, ne tür bir davranış bekleyeceğinizi ve bunun için kime sorumluluk yükleyeceğinizi gösterir. Burada model, bağımsız bir sağlayıcı tarafından çalıştırılan açık ağırlıklı bir modeldir ve sayfalar bunu açıkça belirtmektedir.
- Yayınlanan limitler. Yeniden deneme mantığını tasarlarken istek ve eşzamanlılık sınırlarını bilmelisiniz. Bunlar tam anahtar başına dakikada 300 istek ve 8 eşzamanlıdır.
- Net faturalandırma kuralları. Ön ödemeli kredi, abonelik olmaması ve başarısız çağrılar hakkında bir beyan arayın. Bu durumda başarısız veya reddedilen istekler için ücret alınmaz ve kredi süresi dolmaz.
- Bir gizlilik beyanı. İstemler burada eğitim için kullanılmaz. Size önemli olan ayrıntılar için dokümantasyon ve şartları okuyun.
- Dürüst kapsam. Eksik olanların kısa bir listesi iyi bir işaret olabilir. Yalnızca metin, embedding yok, ince ayar yok, tek model.
Ödeme yöntemleri de bu tablonun bir parçasıdır. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile bakiye yükleme $20'den $500'e kadar mümkündür.
Buna güvenmeden önce
Reddetmeyen bir model, daha az güvenlik duvarı olan bir araçtır; bu nedenle dikkatli kullanın. Serviste tek bir katı limit vardır: reşit olmayanlar ile ilgili cinsel içerik yok. Ürününüz, kullanıcılarınıza ve yerel mevzuata uygun olan filtrelemeyi eklemelidir. Tam parametre listesi için dokümantasyon sayfasını okuyun ve bu uç noktanın kapsamadığı görevler için ikinci bir sağlayıcı yapılandırın.
