Hızlı başlangıç Fiyatlar

Ana sayfa → Yardım

Bir yapay zekâ API'sini çağırırken 405 Method Not Allowed

POST'unuz web sunucusuna ulaştı ama API'ye ulaşmadı. Gönderdiğiniz yol yalnızca GET'e yanıt verir, bu yüzden sunucu isteği değil yöntemi reddeder. Neredeyse her ağ geçidinde bu, base URL'nin bir segment önce bittiği anlamına gelir – API ön eki yerine sitenin köküne işaret eder.

Gördüğünüz hata

Neden oluyor

OpenAI soyundan SDK'lar sizin için bir yol ön eki eklemez. base_url'ye ne yazarsanız birebir kullanılır ve sonuna /chat/completions eklenir. https://example.com verirseniz istek https://example.com/chat/completions adresine gider; çıplak alan adını sonda eğik çizgiyle verirseniz bazı istemciler bunu https://example.com/ olarak daraltır – ana sayfaya düz bir POST.

Bir ana sayfa statiktir. GET ve HEAD'e yanıt verir, geri kalan her şeyi reddeder – bu tam olarak bir 405'tir. İstek hiçbir API koduna ulaşmadığı için kullanım kaydınızda hiçbir şey görünmez – ve boş bir kayıt da başlı başına bir ipucudur.

Bu, Anthropic durumunun ayna görüntüsüdür. Claude Code ve Anthropic SDK /v1/messages'i kendileri ekler, bu yüzden /v1 OLMAYAN bir base URL'ye ihtiyaç duyarlar. Çalışan bir Claude Code ayarını bir OpenAI istemcisine kopyalamak bu hatayı her seferinde yeniden üretir.

Sebebin bu olduğunu doğrulayın

Sunucuya tam olarak o yolun hangi yöntemleri kabul ettiğini sorun:

curl -s -o /dev/null -w '%{http_code}\n' -X POST 'YOUR_BASE_URL/chat/completions'
# and compare with the bare domain:
curl -s -D- -o /dev/null -X POST 'https://YOUR_DOMAIN/' | grep -i '^allow\|HTTP/'

Çıplak alan adı Allow: GET, HEAD başlığıyla 405 döndürüyorsa sebebi buldunuz. Doğru bir API yolu, anahtar eksik olduğunda 401 döndürür – bir kimlik doğrulama hatası, API ile konuştuğunuz anlamına gelir.

Nasıl düzeltilir

  1. API ön ekini base URL'ye geri koyunOpenAI tarzı istemcilerde base URL, API ön ekiyle – normalde /v1 – bitmelidir. SDK onun arkasına /chat/completions ekler, başka hiçbir şey eklemez.
  2. Claude Code değerini yeniden kullanmayınAnthropic soyundaki istemciler çıplak sunucu adını alır, çünkü /v1/messages'i içeride kendileri ekler. İki ayar birbirinin yerine geçebilir gibi görünür ama geçemez.
  3. Sondaki eğik çizgiyi kaldırın/ ile biten bir base URL çift eğik çizgi üretebilir ve bazı yönlendiriciler bunu API yerine ön yüze gönderir – aynı 405, aynı eksik kayıt.
İstemciBase URL şöyle olmalı
OpenAI SDK (Python, Node, Go)/v1 ile bitmeli
Codex, Cherry Studio, Chatbox, LobeChat, LM Studio/v1 ile bitmeli
Cursor, Cline, Roo Code/v1 ile bitmeli
Anthropic SDK/v1 olmadan – /v1/messages yolunu kendisi ekler
Claude Code/v1 olmadan – aynı sebep
APICLAN'da base URL, OpenAI tarzı istemciler için https://apiclan.us/v1, Claude Code ve Anthropic SDK için https://apiclan.us şeklindedir. Her istemci ayarı hızlı başlangıç sayfasında listelenir.

İ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.