Ana sayfa → Yardım

OpenAI uyumlu bir API'yi çağırırken Unexpected token '<' hatası

Gördüğünüz hata

• SyntaxError: Unexpected token '<', "<!doctype "... is not valid JSON
• json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)
• invalid character '<' looking for beginning of value
• Error: Invalid JSON response body

Neden oluyor

OpenAI uyumlu ağ geçitlerinin çoğu web sitesini ve API'yi aynı alan adından sunar. API'nin tanımadığı bir yolu istediğinizde temiz bir 404 almazsınız – sitenin ön yüzünü alırsınız, HTTP 200 ve Content-Type: text/html ile.

İstemcinin gözünden her şey başarılıdır, bu yüzden gövdeyi ayrıştırmaya devam eder. Gördüğünüz hata, bir JSON ayrıştırıcısının HTML belgesinin ilk karakterinden şikâyet etmesidir ve gerçek sorunun yakınından bile geçmez.

Bu, başarısız çağrının sağlayıcının hata kayıtlarında genellikle iz bırakmadığı anlamına da gelir – 200 bir hata değildir. Destek ekibi size bir sorun görmediğini söyleyecektir ve doğruyu söylüyordur.

Sebebin bu olduğunu doğrulayın

Tek komutla doğrulayın. Bir istek gönderin ve gövdeye değil içerik türüne bakın:

curl -s -o /dev/null -w '%{http_code} %{content_type}\n' \
  -X POST 'YOUR_BASE_URL/chat/completions' \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model":"MODEL","messages":[{"role":"user","content":"hi"}]}'

Çalışan bir uç nokta application/json döndürür – anahtar yanlış olsa bile bunu söyleyen bir JSON alırsınız. text/html görüyorsanız sorun anahtarda değil, URL'dedir.

Nasıl düzeltilir

1. İstemcinizin /v1'i kendisinin ekleyip eklemediğini kontrol edinTuzağın tamamı bu. OpenAI SDK'ları /v1 eklemez – base URL'ye sizin yazmanız gerekir. Anthropic SDK ve Claude Code ise kendisi ekler; onlara zaten /v1 ile biten bir base URL verirseniz /v1/v1/messages oluşur ve aynı şekilde başarısız olur.
2. Sondaki eğik çizgiye dikkat edinBazı istemciler yolları özensizce birleştirir. Eğik çizgiyle biten bir base URL, son yolda çift eğik çizgi oluşturabilir; bazı ağ geçitleri bunu API'ye değil ön yüze yönlendirir.
3. API sunucusunu kullandığınızdan emin olunSağlayıcı ayrı bir API alt alan adı sunuyorsa, ana alan adı aynı yollarda pazarlama sitesini sunuyor olabilir. URL'nin şekli aynı, işleyen tamamen farklı.

İlgili konular

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.