Ana sayfa → Yardım

/responses için 404 – Responses API de sürüm ön ekine ihtiyaç duyar

Responses API, diğer her şeyle aynı sürüm ön ekinin altındadır. chat/completions /v1/chat/completions adresinde çalışıyorsa, responses /v1/responses adresindedir. /responses adresine giden bir istek API'ye değil web sitesine düşer.

Gördüğünüz hata

404 Not Found on /responses
openai.NotFoundError: Error code: 404
The same key works for chat/completions but not for responses
Nothing appears in the usage log for the failed call

Neden oluyor

Ön ek tek tek uç noktalara değil base URL'ye aittir. base_url bir kez /v1 ile bittiğinde SDK desteklediği her uç nokta için doğru yolu üretir ve bir daha düşünmeniz gerekmez.

Bozulduğu yer elle yazılmış isteklerdir. Biri, tam URL'yi açıkça yazan bir blogdan curl örneği kopyalar, sunucu adını değiştirir ve düzenleme sırasında ön eki kaybeder.

404 uç katmanda döndüğü için hesabın istek geçmişinde iz bırakmaz. İnsanlar o zaman uç noktanın hiç desteklenmediğini varsayar, oysa ona hiç ulaşmamışlardır.

Sebebin bu olduğunu doğrulayın

İki yolu aynı anahtarla karşılaştırın – fark nettir:

curl -s -o /dev/null -w 'no prefix: %{http_code}\n' -X POST \
  'https://YOUR_DOMAIN/responses' -H 'Authorization: Bearer YOUR_KEY'
curl -s -o /dev/null -w 'with /v1:  %{http_code}\n' -X POST \
  'https://YOUR_DOMAIN/v1/responses' -H 'Authorization: Bearer YOUR_KEY'

Birincide 404, ikincide 400 ya da 200 bunu doğrular. İkincide 401 yolun doğru, anahtarın yanlış olduğu anlamına gelir – bu başka bir sorundur.

Nasıl düzeltilir

Ön eki bir kez, base_url'de ayarlayın/v1'i base URL'nin sonuna koyun ve her uç nokta yolunu SDK'nın oluşturmasına izin verin. Tek tek URL'leri düzenlemek, ön ekin kaybolduğu yoldur.
Ağ geçidinin gerçekte hangi uç noktaları sunduğunu kontrol edinHer OpenAI uyumlu ağ geçidi Responses API'yi uygulamaz. /v1/chat/completions çalışırken /v1/responses 404 döndürüyorsa ön ek doğrudur ve uç nokta gerçekten yoktur – onun yerine chat/completions kullanın.

APICLAN, /v1/responses, /v1/chat/completions ve /v1/messages uç noktalarını aynı base URL ve aynı anahtarla sunar. Hangi modelin hangi uç noktada yanıt verdiği GET /v1/models çıktısında yer alır.

İlgili konular

OpenAI uyumlu bir API'yi çağırırken Unexpected token '<' hatası 401 invalid API key – anahtar doğru göründüğü halde hata veriyorsa

Son kontrol: 2026-10-01. Canlı bir OpenAI uyumlu ağ geçidinde teşhis edilen sorunlardan yazılmıştır, başka sitelerden derlenmemiştir.