PicoClaw model bulunamadı 404: model kimlikleri ve Anthropic protokolleri

PicoClaw'da "model bulunamadı" ve 404 dört farklı hatadır ve bunlardan yalnızca biri makinenizin dışında gerçekleşir. Üçü yereldir — çözümlenemeyen bir diğer ad, PicoClaw'un kendi web arka ucunun 404 yanıtı ve bilinmeyen bir protokol dizesi — dördüncüsü ise gövdesi rotanın mı yoksa model kimliğinin mi yanlış olduğunu söyleyen bir üst akış 404'üdür. Protokolleri bir yazım hatasını düzeltmek için değiştirmenizi engelleyen şey, önce hata metnini okumaktır.

Bu sayfa, çalışan bir model_list girdiniz ve anahtarınız olduğunu varsayar; kurulumun kendisi ve PicoClaw'un maliyeti PicoClaw fiyatlandırması ve API kurulumu bölümünde ele alınır. Aşağıdaki her şey, releases API'sinin 21 Eylül 2026'da en güncel olarak doğruladığı ve 3 Temmuz 2026'da yayımlanan v0.3.1 sürüm etiketinden okunmuştur. Depoya son gönderim 17 Eylül 2026'da yapıldığından main etiketten ileridedir — bunun önemli olduğu yerlerde belirtilmiştir. 1 Ekim 2026'da v0.3.1 hâlâ en güncel sürümdü; sürüm ikilisi daha sonra yerel bir kayıt uç noktasına ve kasıtlı olarak geçersiz bir anahtarla Kunavo'ya karşı çalıştırıldı; bunun gösterdiği şey aşağıda kaydedilmiştir.

Dört hata, tek ifade

İsteğin makinenizden çıkıp çıkmadığını belirlemek bu nedenle ilk iş olmalıdır; yalnızca dize bunu kesinleştirir. Diğer ad uyuşmazlığı varsayımsal değil, dosyalanmış bir vakadır: PicoClaw issue #958, error creating provider: model "llama3.2" not found in model_list bildirimini raporlar; picoclaw status ise Ollama uç noktasına erişilebildiğini ve modelin llama3.2:latest olarak mevcut olduğunu göstermiştir. Issue, 25 Mart 2026'da deponun eski issue botu tarafından kapatıldı. Bu depoda tamamlandı olarak işaretlenmiş kapalı bir issue'nun düzeltilmiş anlamına gelmediğine dikkat edin — aynı bot #1624'ü de aynı ifadeyle kapattı.

Sarmalayıcı metin, gerçekten çalıştırılan protokolü adlandırır

anthropic ile api key kullanıldığında ve anthropic-messages farklı sağlayıcılar oluşturulduğundan, 404 sarmalayıcıları farklıdır — bu da hata dizesini ücretsiz bir tanılama aracına dönüştürür.

PicoClaw'un kendi 404 tavsiyesi sizi neden yanlış yola yönlendirebilir

PicoClaw'un sağlayıcı kılavuzu, "Mevcut anthropic protokolü 404 hataları döndürüyorsa (uç noktanın OpenAI uyumlu biçimi desteklemediğini gösterir)" anthropic-messages protokolüne geçmenizi söyler ve adlandırmayı açıklığa kavuşturan şu notu ekler: "anthropic protokolü OpenAI uyumlu biçim (/v1/chat/completions) kullanırken anthropic-messages Anthropic'in kendi biçimini (/v1/messages) kullanır." Her iki alıntı da 21 Eylül 2026'da v0.3.1'de yeniden okundu.

Bu tavsiye rota 404'ü için doğru, model 404'ü için yanlıştır. Ayrıca aynı dosyada bir tablonun 294 satır altında yer alır; bu tablo, anthropic satırının Protocol sütununda Anthropic yazarak bunun tersini söyler. Kod çelişkiyi açık olmayan bir şekilde çözer: anthropic, auth_method değerine bağlı olarak iki protokoldür. oauth veya token ile yerleşik Anthropic SDK sağlayıcısını oluşturur ve tablo doğrudur; API anahtarıyla openai ve tüm ailesi tarafından kullanılan aynı OpenAI uyumlu sağlayıcıya düşer ve not doğrudur.

Bundan doğrudan iki sonuç çıkar. openai ailesinde https://api.kunavo.com/v1 yerine https://api.kunavo.com yazmak şu adresi oluşturur: https://api.kunavo.com/chat/completions — kendi yapılandırmanızın neden olduğu ve en yaygın olan rota 404 hatası. Her iki Anthropic protokolünde bu hata imkânsızdır, çünkü /v1 her iki durumda da zorunlu olarak eklenir; ancak aynı zorlama, yolu bitmemesi gereken bölüm /v1 olan bir ağ geçidinin bunlar üzerinden hiç yapılandırılamayacağı anlamına gelir ve bunun yerine openai protokolünü kullanması gerekir. PicoClaw'un kendi belgeleri, temel URL'si farklı bir sürüm bölümüyle biten bir satıcı için bu kaçış yolunu kullanır.

Çözümlenmemiş kabul edilmesi gereken bir iddia. PicoClaw issue #269 hakkındaki tek yorum, /v1/chat/completions uç noktasına gönderim yapmanın Anthropic'te 404 döndürdüğünü, çünkü doğru uç noktanın /v1/messages olduğunu ileri sürer. Anthropic'in kendi belgeleri bununla çelişir: OpenAI SDK uyumluluk katmanı sunar; bu katman base_url olarak https://api.anthropic.com/v1/ kullanır ve authorization başlığını "Fully supported" olarak işaretler (21 Eylül 2026'da kontrol edildi); aynı sayfada katmanın "çoğu kullanım durumu için uzun vadeli veya üretime hazır bir çözüm olarak değerlendirilmediği" konusunda uyarır. Issue #269, 13 Mart 2026'da kapanış yorumu olmadan kapatıldı — issues API'si, yukarıdaki analizi yapan ve depoyla ilişkisi olmayan bir hesaptan gelen tek bir yorum gösterir — dolayısıyla onu gerçekte neyin çözdüğü bilinmiyor. Her iki anlatım yerine kendi 404 yanıt gövdenize güvenin.

404, model kimliğinden kaynaklandığında

PicoClaw issue #1624 — 16 Mart 2026'da açıldı, 31 Mart 2026'da kapatıldı — "model": "anthropic/claude-sonnet-4.6" olarak yapılandırılmış noktalı bir Claude kimliği için şu tam gövdeyi kaydeder: Status: 404 ve {"error":{"code":"not_found_error","message":"model: claude-sonnet-4.6 was not found. Did you mean claude-sonnet-4-6?"…. Başlığı ve tek yorumu 21 Eylül 2026'da issues API'sinden yeniden okundu: yorum eski issue botuna aittir; bu nedenle issue kapalıdır ancak düzeltme yapıldığına dair kanıt yoktur.

"Did you mean" ipucu belirleyicidir. Yalnızca isteği ayrıştırmış bir uç noktadan geri döner; dolayısıyla rota çalışmıştır ve hiçbir protokol değişikliği yardımcı olmaz. PicoClaw'un yazımı sizin için düzeltmemesinin nedeni dar kapsamlı ve denetlenebilirdir: strings.ReplaceAll(model, ".", "-") depoda bir kez, SDK sağlayıcısının kullanıldığı OAuth ve token yollarındaki pkg/providers/anthropic/provider.go dosyasının 219. satırında bulunur. Ne anthropic_messages/provider.go ne de openai_compat/provider.go bunu içerir. Her iki ifade de 21 Eylül 2026'da v0.3.1'de yeniden kontrol edildi; bu sayfadan önceki araştırma aynı gün main'den aynı dosyaları yeniden çekti ve aynı sonucu aldı. 1 Ekim 2026'da v0.3.1 ikilisinin çalıştırılması bunu her iki API anahtarı yolunda doğruladı: noktalı kimlik, tam yazıldığı gibi uç noktaya ulaştı ve uç noktanın kendi 404 yanıtıyla geri döndü (bkz. v0.3.1'in çalıştırılmasının gösterdikleri). Yeniden yazmanın bulunduğu tek yol olan OAuth ve token yolu çalıştırılmadı.

PicoClaw'un kendi dosyaları da yazım konusunda çelişir: provider_metadata.go, her iki Anthropic girdisi için tireli kimlikler listeler; sağlayıcı kılavuzundaki anthropic örneği noktalı bir kimlik kullanır; anthropic-messages ise GetDefaultModel'ten noktalı bir varsayılan döndürür — #1624'ün reddedildiğini gösterdiği yazım aynıdır. Anthropic'in model genel bakışında yazdırılan her Claude API kimliği tire kullanır; sayfa Claude Sonnet 4.6 ve Claude Opus 4.6'yı "Legacy models (still available)" altında listeler — dolayısıyla bugün Anthropic'te 4.6 kimliğinin 404 vermesinin nedeni kullanımdan kaldırılmış olması değildir. Bu, bir nedeni eler ama tüm nedenleri değil: modeli taşımayan bir ağ geçidi tireli bir kimliği yine de reddedebilir. Kimliği bir README'den değil, çağırdığınız uç noktadan kopyalayın.

Her iki girdiyi açıkça yazın ve kimliği tireli tutun. Anahtarlar bu dosyaya ait değildir — PicoClaw bunları ~/.picoclaw/.security.yml dosyasından okur; bu konu kurulum kılavuzunda ele alınmıştır.

{
  "agents": {
    "defaults": {
      "model_name": "kunavo-sonnet"
    }
  },
  "model_list": [
    {
      "model_name": "kunavo-sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "api_base": "https://api.kunavo.com/v1"
    },
    {
      "model_name": "kunavo-sonnet-native",
      "provider": "anthropic-messages",
      "model": "claude-sonnet-4-6",
      "api_base": "https://api.kunavo.com"
    }
  ]
}

İlk girdi /v1 bölümünü kendisi sağlar; çünkü OpenAI uyumlu aile /chat/completions yolunu api_base değerine aynen ekler. İkinci girdi bunu bilerek atlar ve anthropic-messages üzerinde her iki yazımın aynı temele normalleştirildiğini gösterir. Kunavo'nun yayımlanmış temel URL'leri, https://api.kunavo.com/v1 adresiyle chat completions için ve https://api.kunavo.com/v1/messages adresiyle Messages rotası için belirtilir. İki URL aritmetiği kümesinin örtüşmesi, iki belge kümesi üzerindeki aritmetiktir — 1 Ekim 2026'da her iki girdi de v0.3.1 kullanılarak Kunavo'ya kasıtlı olarak geçersiz bir anahtarla çalıştırıldı: openai girdisi /v1/chat/completions yoluna, anthropic-messages girdisi ise /v1/messages yoluna ulaştı ve her biri Kunavo'nun 401 yanıtını aldı. Bu, URL'leri kanıtlar; tamamlanmış bir isteği değil: bu sayfadaki hiçbir iddia test edilmiş bir entegrasyon olduğunu söylemez. Temel URL sorusunun genel biçimi için Anthropic temel URL belgesine bakın.

Bir ağ geçidi de kasıtlı olarak 404 yanıtı verebilir ve bu bir PicoClaw hatası değildir. Kunavo, geçici olarak duraklatılmış bir model için modelin adını ve bunun yerine kullanılacak modeli belirten bir gövdeyle 404 döndürür ve duraklatılmış modelleri /v1/models'den çıkarır; hangi modellerin duraklatıldığı değiştiği için belirli bir adla değil, bu mesajın yapısıyla eşleştirin. Kunavo ayrıca embedding, metinden konuşmaya veya konuşmadan metne modeli sunmaz; bu nedenle bunlardan birini adlandıran bir model_list girdisi, hangi protokolü seçerseniz seçin 404 döndürür — bu girdileri başka bir sağlayıcıya yönlendirin ve Kunavo anahtarında yalnızca chat girdilerini tutun.

v0.3.1 çalıştırıldığında görülenler

1 Ekim 2026'da, sürümün kendi checksum dosyasına karşı checksum doğrulaması yapılan v0.3.1 sürüm ikilisi, her seferinde bir model_list girdisi ve picoclaw agent -m ile geçici bir kapsayıcıda çalıştırıldı. Uç nokta, o sırada Kunavo'nun yönlendirmesi gibi davranan yerel bir kayıt sunucusuydu — /v1/* API'dir, diğer tüm yollar HTML 404 sayfası döndürüyordu (Kunavo artık bu yollar için düzeltmeyi belirten bir JSON 404 yanıtlıyor; Kunavo satırlarına bakın) — ve claude-sonnet-5 ile claude-sonnet-4-6 değerlerini biliyor, ancak noktalı kimliği bilmiyordu; son üç satırda, kasıtlı olarak geçersiz bir anahtarla gerçek api.kunavo.com kullanıldı, bu nedenle hiçbir işlem faturalandırılmadı.

Bu çalıştırmanın kesinleştirdiği ve kaynak kodu incelemesinin yalnızca öngörebildiği iki nokta var. Hata sarmalayıcısı, gerçekten çalıştırılan sağlayıcıyı belirtiyor; dolayısıyla protokolü buradan okumak güvenlidir. Noktalı bir kimlik, API anahtarı kullanılan her iki yolda da değiştirilmeden gönderiliyor; bu nedenle noktalı bir kimliği alıntılayan "model bulunamadı" hatası, protokol değiştirilerek değil, kimliğin yeniden yazılmasıyla düzeltilir. Kapsam dışında kalanlar: OAuth ve token yolları, başlatıcının web arayüzü, akış ve Kunavo üzerinden tamamlanan tüm istekler — Kunavo satırlarında kasıtlı olarak geçersiz bir anahtar kullanıldı.

En kısa kontrol sırası

1. Makineden herhangi bir şey çıktı mı? HTTP durumu içermeyen ve model_list içinde bulunamadı ifadesini içeren bir terminal hatası yereldir. agents.defaults.model_name değerini bir model_name girdisine eşitleyin ve burada durun.
2. localhost'tan mı geldi? PicoClaw'nun web arayüzünde varsayılan model seçilirken tarayıcıda görülen 404, PicoClaw'nun kendi arka ucunun sunduğu aynı uyumsuzluktur. Herhangi bir model API'si kullanılmadı.
3. Hangi sağlayıcı çalıştı? Sarmalayıcı metnini yukarıdaki tabloyla eşleştirin. Sarmalayıcı, yapılandırdığınızı düşündüğünüz protokolle eşleşmiyorsa provider alanı veya model ön eki düşündüğünüz gibi değildir.
4. Yönlendirme 404'ü mü, model 404'ü mü? Modelinizi belirten bir gövde — özellikle did you mean ipucuyla birlikte — model 404'üdür: kimliği düzeltin. Bir HTML sayfası, boş bir gövde veya genel bir bulunamadı yanıtı yönlendirme 404'üdür: başka hiçbir şeye dokunmadan önce oluşturulan URL'yi tablodan yeniden çıkarın.
5. Uç noktaya ne sunduğunu sorun. Her iki Anthropic protokolünde de hiçbir katalog girdisi fetch bayrağını ayarlamadığı için PicoClaw bunu yapamaz. Ağ geçidinin kendi /v1/models uç noktasına istek göndermek için curl kullanın veya aynı ağ geçidini geçici olarak openai protokolüne yönlendirin. Sağlayıcılar arasında model bulunamadı bu yöntemi, Anthropic 404 model bulunamadı ise sorunun kimliğin kendisi olduğu durumları kapsar.
6. Protokolleri yalnızca şimdi değiştirin ve bunu yalnızca 4. adım yönlendirme 404'ü dediyse yapın. Engel tel biçimi değil de kimlik doğrulama üst bilgisi ise auth token ve api key karşılaştırması ayrımı açıklar.
7. Düz bir sohbet turu yerine tek araç turuyla yeniden doğrulayın. Yalın bir mesaja yanıt veren yapılandırma, ilk araç çağrısında yine başarısız olabilir; bu nedenle düzeltmeyi doğrulamak için kullandığınız sınırlı görev bir araç çağrısı içermelidir.

Protokol seçiminin size maliyeti

En büyük maliyet sonucu, bir ayar olmaktan ziyade yapısal olan istem önbelleğe almadır. PicoClaw v0.3.1'de önbellek kesme noktası oluşturan tek kod pkg/providers/anthropic/provider.go dosyasındadır ve bu koda yalnızca OAuth ve token yollarında ulaşılır. API anahtarıyla — kendi anahtarınızı getirdiğiniz olağan durumda — hiçbir Anthropic protokolü cache_control göndermez. Anthropic'in kendi uyumluluk katmanı kullanıldığında bu sorun daha da büyür; çünkü belgelerinde açıkça "İstem önbelleğe alma desteklenmez, ancak Anthropic SDK'larında desteklenir" denir. OpenAI biçimindeki çağıranlar için kesme noktaları ekleyen bir ağ geçidi kullanıldığında tasarruf bunun yerine ağ geçidinde elde edilir; Kunavo'nun önbelleğe alma belgeleri bunu yaptığını ve kapsamı tam olarak /v1/chat/completions veya /v1/responses üzerinden erişilen Claude modelleriyle sınırladığını söyler. Aynı sayfa, cache_control alanının Anthropic'e özgü Messages yolunda çeviri yapılmadan iletildiğini de belirtir — dolayısıyla anthropic-messages girdisi iki taraftan da kesme noktası almaz ve aşağıdaki ikinci sütun yalnızca openai protokolünü kullanan girdiyi açıklar. Diğer ağ geçitlerinin kesme noktaları ekleyip eklemediği kontrol edilmedi ve bunların hiçbiri PicoClaw içinden gözlemlenmedi.

Bunun değeri, ölçülmüş bir görev maliyeti veya fatura tavanı değil, açıklayıcı token aritmetiğidir. 10 araç turundan oluşan tek bir aracı turu varsayın; her tur aynı 20.000 tokenlık ön eki (sistem istemi, araç şemaları, o ana kadarki döküm) yeniden gönderiyor, 1.000 yeni giriş tokenı ekliyor ve 600 çıkış tokenı döndürüyor. Bu oranlar yalnızca açıklama amacıyla varsayılmıştır. İlk sütun her turun girdisini tam ücret üzerinden faturalandırır; ikinci sütun ise ikinci turdan itibaren tekrarlanan ön eki önbellek okuma ücreti üzerinden faturalandırır. Ücretler, milyon token başına canlı Kunavo kataloğu fiyatlarıdır.

Bu varsayımlar altında Claude Sonnet 4.6, aynı iş için $0,504 değerinden $0,164 değerine düşer. İkinci sütunu iyimser bir tahmin olarak okuyun: önbellek yazmaları kendi ücretleri üzerinden faturalandırılır ve her iki yönde de modellenmemiştir; her turda değişen bir ön ek ise hiçbir zaman önbellek isabeti oluşturmaz. Bunlardan herhangi birini bütçe olarak değerlendirmeden önce günlük tur sayısıyla ölçeklendirin.

Bu sırada iki faturayı ayrı tutun. PicoClaw'nun kendisi ücretsizdir — depo MIT lisanslıdır ve her iki Anthropic protokolü de dahil olmak üzere hiçbir protokol satın alınması gereken bir şeyin arkasında kısıtlanmamıştır. Tekrarlayan maliyet, sağlayıcınızın ücretindeki model tokenlarıdır. Kunavo kataloğundaki tutar bir tavan değil, faturalandırma tabanıdır: üst kaynak ücretini bildirdiğinde fatura, katalog maliyeti ile üst kaynak maliyetinin geçerli işaretlemeyle çarpımından büyük olanıdır. Minimum yükleme, görev ücreti veya abonelik değil, $10 ön ödemeli kredidir — faturalandırma ayrıntılarına bakın.

Doğrudan sağlayıcı, ağ geçidi, abonelik veya yerel

Çalışma zamanını mı, yoksa yönlendirmeyi mi seçiyorsunuz? PicoClaw ve OpenClaw, ikisini dağıtım yapısı açısından karşılaştırır. Bir ağ geçidinde karar kılar ve bir anahtara bakiye yüklemek isterseniz Kunavo hesabı oluşturun, ardından içinde bir araç çağrısı bulunan tek bir sınırlı görev gönderin ve hesabınızın gerçekten kaydettiği ücreti okuyun.

Sık sorulan sorular

21 Eylül 2026'da kontrol edildi. Bu görevde v0.3.1 etiketinde yeniden doğrulandı: sağlayıcılar kılavuzunun protokol notu ve Anthropic sağlayıcı satırı, anthropic dalı ve factory_provider.go dosyasındaki varsayılan kol, NormalizeBaseURL, anthropic-messages için URL, üst bilgiler ve 404 dizesi, openai_compat bileşeninin URL birleştirmesi ve Bearer üst bilgisi, HTTP öncesi üç "not found in model_list" dizesi, web arka ucunun 404'ü, noktadan tireye dönüşümün tek oluşumu, sağlayıcı seçenekleri tablosunun SupportsFetch sütunu ve docs/operations/troubleshooting.md dosyasındaki OpenRouter örneği; ayrıca releases API (v0.3.1, 3 Temmuz 2026'da yayımlandı) ile #1624, #958 ve #269 numaralı sorunların başlıkları, durumları, tarihleri ve yorumları. Anthropic'in OpenAI-SDK uyumluluk sayfası da aynı gün okundu. 1 Ekim 2026'da çalıştırıldı: bir kapsayıcıda yerel kayıt uç noktasına karşı ve geçersiz bir anahtarla Kunavo'ya karşı v0.3.1 sürüm ikilisi — yukarıdaki tablonun her satırı. Doğrulanmadı: araştırmada karşılaştırılan dosyaların ötesinde main üzerindeki herhangi bir şey, #269 numaralı sorunun kapanmasını neyin sağladığı, OAuth ve token yolları ve Kunavo üzerinden tamamlanan herhangi bir istek. Kunavo token ücretleri canlı katalogdan alınır ve buradaki her dolar tutarı örnek amaçlı token hesabıdır.