Codex API Temel URL: İstemcinizi Nasıl Bizimkine Yönlendirirsiniz

İhtiyacınız olan üç değer

Her OpenAI uyumlu istemci aynı üç şeyi ister. İşte bu hizmet için bunlar:

Anahtar Authorization: Bearer YOUR_KEY olarak gönderilir. Çağırabileceğiniz iki uç nokta POST /v1/chat/completions ve GET /v1/models'dir. Bu bağımsız bir hizmettir ve tek bir open-weight model çalıştırır; OpenAI'nin Codex'i değildir, bu nedenle OpenAI'nin kendi uç noktasını veya OpenAI anahtarını aynı ayara yapıştırmayın.

Bağlantıyı curl ile kontrol edin

Herhangi bir uygulama yapılandırmasını düzenlemeden önce, anahtarın ve URL'nin terminalden çalıştığını doğrulayın. Modelleri listelemek en ucuz kontroldür, çünkü bir isteme ihtiyaç duymaz:

Copycurl https://api.getcodexapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Model uncensored'i içeren bir JSON listesi almalısınız. Ardından gerçek bir tamamlama isteği gönderin:

Copycurl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

Her iki çağrı da çalışırsa, sonraki tüm hatalar hizmette değil, istemci yapılandırmanızdadır. Yanıt başlıkları X-Request-Id'i içerir; bu, belirli bir çağrıyı izlemeniz gerekirse tutulması faydalıdır ve X-Balance-USD'i içerir; bu kalan kredinizi gösterir.

OpenAI SDK ile Python

Resmi openai paketi base URL'yi istemci yapıcısında alır. Kodunuzun geri kalanı değişmez.

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.getcodexapi.com/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a base URL is in two sentences."},
    ],
)
print(resp.choices[0].message.content)

Yapılandırmayı koddan uzak tutmak isterseniz, SDK ayrıca OPENAI_BASE_URL ve OPENAI_API_KEY'i ortamdan okur:

Copyexport OPENAI_BASE_URL="https://api.getcodexapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

Bunlar ayarlandığında, argümansız OpenAI() bunları otomatik olarak alır. Bu kullanışlıdır çünkü SDK üzerine kurulu birçok üçüncü taraf araç, kod değişikliği olmadan aynı değişkenleri miras alır.

Node.js

JavaScript SDK aynı seçenek adını kullanır: baseURL.

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.getcodexapi.com/v1",
  apiKey: process.env.API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about version control." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Akış, stream: true ile sunucu tarafından gönderilen olaylar olarak döner ve kullanım bilgisi sonunda dahil edilir. Akışlı bir istek, akış bitene kadar eşzamanlılık slotlarınızdan birini tutar; bu nedenle kapatmadan terk ettiğiniz bir akış, limitinize sayılır.

Ayar ekranı olan uygulamalar

Masaüstü araçları ve editörler genellikle alanı üç yoldan biriyle etiketler: "Base URL", "API Base" veya "OpenAI uyumlu uç nokta". Hepsi aynı dizeyi ister. Zaman kazandıran birkaç not:

• Satıcıya özgü bir tür yerine OpenAI veya "özel OpenAI uyumlu" sağlayıcı türünü seçin.
• Uygulama serbest metin kutusuna sahipse model adını elle yazın. uncensored tam ID'dir.
• Uygulamanın "bağlantıyı test et" düğmesi varsa, genellikle modeller listesini çağırır; bu API bunu destekler.
• Bazı uygulamalar model listesini önceki bir sağlayıcıdan önbelleğe alır. Açılır menü yanlış görünüyorsa eski girişi kaldırın ve yeni bir tane ekleyin.

Belirli bir editörde örnek bir uygulama için Cursor'a bağlanma kılavuzuna bakın veya genel resim için coding API sayfası'ne bakın. Tam parametre referansı API belgeleri'dedir.

Bağlantı çalıştıktan sonra, bulabileceğiniz bir yere tam değerleri kaydedin: URL, model adı ve anahtarınızı oluşturduğunuz tarih. Ekipler, yapılandırma kopyasının hala eski bir değer içerdiği için daha sonra bir saat kaybedebilir. Depoda, gerçek anahtar yerine bir yer tutucu içeren tek bir ortak örnek dosya bunu önler.

Yaygın hatalar ve çözümler

URL /v1/v1 olarak sona erer

Bazı istemciler kendi başlarına /v1 ekler. İstekleriniz başarısız olursa ve istemci günlüğü /v1/v1/chat/completions içeren bir yol gösterirse, girdiğiniz base URL'den /v1'i kaldırın. Ters durum da olur: bunu eklemeyen bir istemci, ayarınızda bunu gerektirir. İstek yolunun günlüğü sorunu hızla çözer.

Tam uç noktayı base URL'ye yazdınız

Base URL /v1'de biter. Oraya /chat/completions yazmayın. SDK her çağrı için yolu ekler.

Sonlandırma eğik çizgisi veya ana makinede yazım hatası

Çoğu SDK sonlandırma eğik çizgisini tolere eder, ancak bazı eski araçlar yolları düz birleştirme ile oluşturur ve çift eğik çizgi ile sonuçlanır. Garip 404 yanıtları görürseniz kaldırın.

Yanlış anahtar veya başka bir hizmetin anahtarı

Bir OpenAI anahtarı burada çalışmaz, bizim anahtarımız orada çalışmaz. API anahtarı hataları neredeyse her zaman kopyala-yapıştır sorunundan kaynaklanır; örneğin eksik bir karakter veya sondaki bir boşluk.

curl'de çalışır ama uygulamanızda çalışmaz

curl başarılı olursa ve uygulama aynı URL ve anahtarla başarısız olursa, fark ortamdadır. Uygulamanın bir proxy'nin arkasında çalışıp çalışmadığını, dışa çıkış erişimi olmayan bir kapsayıcı içinde olup olmadığını, eski bir ortam değişkeni (örneğin başka bir projeden kalan eski OPENAI_BASE_URL) okuyup okumadığını ve bir yapılandırma dosyasının kodda ayarladığınız değeri geçersiz kılıp kılmadığını kontrol edin. İstemcinin çağıracağı son URL'yi istekten hemen önce yazdırmak bu durumların çoğunu bir dakika içinde çözer.

HTTP 429

Bu, bir sınırın aşıldığını gösterir. rate_limited hata kodu dakikadaki istek sayısını, concurrency ise aynı anda gönderilen fazla istek sayısını ifade eder. Tam anahtar 8 eşzamanlı istek ve dakika başına 300 istek izni verir; deneme anahtarı ise 2 ve 60'a izin verir. Geçici aşırı yüklenmelerde ayrıca Retry-After: 5 üst bilgisi içeren bir 429 yanıtı alırsınız; bu durumda beş saniye bekleyip tekrar deneyin.

LangChain ve URL'yi tek bir yerde tutmak

OpenAI istemcisi üzerine kurulu çerçeveler aynı değerleri alır. LangChain'in OpenAI entegrasyonunda argümanlar şöyle adlandırılır:

Copyfrom langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="uncensored",
    base_url="https://api.getcodexapi.com/v1",
    api_key="YOUR_API_KEY",
)
print(llm.invoke("Name three uses of a base URL.").content)

Çerçeve ne olursa olsun, URL'yi kodunuzda dağıtmayın. Bunu tek bir ortam değişkenine veya tek bir yapılandırma dosyasına koyun ve oradan okuyun. Bu şekilde, test anahtarından üretim anahtarına veya makineler arasında geçiş yapmak tek bir satırı değiştirmeyi gerektirir. Ayrıca anahtarları depodan uzak tutar: anahtarı bir ortam değişkeninde veya bir gizli yöneticide saklayın, commit edilmiş bir dosyada değil.

OpenAI'nin kendi Codex ürünleri için uç nokta arıyorsanız, bu değil. Onların base URL'si ve kimlik doğrulaması OpenAI tarafından belgelenmiştir, bu nedenle bunun için mevcut belgelerine bakın. Bu sayfadaki adres bağımsız bir hizmete aittir ve yalnızca burada verilen anahtarları kabul eder.

Bağlandıktan sonra gönderebilecekleriniz

Uç nokta, akış, fonksiyon çağırma (tools, tool_choice, sonuçlar role: "tool" mesajları olarak döndürülür) ve JSON modunu (response_format: {"type": "json_object"}) destekler. temperature, top_p, stop, seed parametreleri ve cezalar doğrudan iletilir. Bağlam penceresi, istem ve tamamlama için toplam 100.000 token'dır ve maksimum istek gövdesi 8 MB'dir.

Bu bir metin modelidir. Görüntü veya ses üretimi, yerleştirme (embedding) ve ince ayar (fine-tuning) yoktur; bu özelliklere dayanan bir istemci özelliği bu Base URL ile çalışmayacaktır. Kullanım, token başına faturalandırılır: 1M giriş için $0,15 ve 1M çıktı için $0,50; fiyatlandırma sayfası üzerinde çalışılmış örnekler bulunmaktadır.

Daha fazla kılavuz

• Codex API Fiyatlandırması: Token Başına Ödeme Oranları ve Örnekler
• Cursor için Codex API: Sansürsüz Bir Modeli Bağlayın
• Cursor için Sansürsüz LLM API