Dokümantasyon

Dokümantasyon

Amp

Amp, modelleri sunucu tarafında yönlendirir; bu nedenle makinenizde ayarlamanız gereken bir temel URL değişkeni yoktur. Model Routing bölümüne bir Custom URL bağlantısı eklersiniz, Amp'in bulut sunucuları da uç noktayı çağırır. Bu özellik ücretli bir planın arkasındadır; kontrol etmeniz gereken ilk şey planınızdır.

Amp'in Model Routing bölümündeki Custom URL bağlantısı — API formatı chat-completions, temel URL https://api.kunavo.com/v1, anahtar bearer token olarak — seçeneğin bulunduğu segmentlerde eşlenen modelleri tek anahtara taşır.

Ayarlar → Model Yönlendirme → Ekle → Özel URL
Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol
Önce Amp planınızı kontrol edin. Amp'in Model Routing sayfasında, 2026-09-21 tarihinde şu yazıyor: “AI model routers and gateways are experimental and in early access for Megawatt, Gigawatt, and Enterprise customers only. We will roll them out to everyone soon.” Custom URL bağlantısı da bu sınıfa girer; bu nedenle Hobby hesabındaki Add menüsünde görünmez. Amp herhangi bir kullanıma sunulma tarihi yayımlamadı ve bu sayfa da böyle bir tarih öngörmüyor.
Kunavo, Amp'i bu uç noktada çalıştırmadı. Yukarıdaki tüm alanlar, burada tamamlanmış bir oturumdan değil, doğrudan Amp'in kendi belgelerinden alınmıştır; bu özellik ücretli bir Amp planının arkasındadır. Bunu Amp'in teknik özelliklerinin aktarımı olarak değerlendirin; çalışıp çalışmadığını Check Access size bildirsin.
chat-completions temel URL'deki /v1 son ekini korur; çünkü Amp yalnızca rotayı ekler. Bunu açıklığa kavuşturan, Amp'in kendi örnek cümlesidir: “https://api.example.com/v1 temel URL'si ve chat-completions ile istekler https://api.example.com/v1/chat/completions adresine gönderilir.” Aynı sayfada, sonu zaten /v1 ile biten bir temel URL'nin “kabul edildiği ve iki kez eklenmediği” de belirtilir. Ayrıca bağlantı formu, siz yazarken istek URL'sini gösterir; böylece kaydetmeden önce birleştirilmiş URL'yi görebilirsiniz.
Amp'in Dictation ve Realtime Voice sistem modelleri ses özellikleridir; Kunavo hiçbir konuşmadan metne veya metinden konuşmaya modeli sunmaz. Buradaki Custom URL bağlantısı bunlardan hiçbirine hizmet edemez; bu satırları Amp'e bırakın.
Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Amp kurulumunda açılır.

Adım adım

  1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
  2. Kişisel ayarlarınızda Model Routing bölümünü açın (bir bağlantıyı tüm üyelerle paylaşmak için çalışma alanı yöneticileri Workspace Model Routing bölümünü kullanır), Add menüsünü açın ve Custom URL seçeneğini belirleyin.
  3. API biçimini chat-completions, temel URL'yi https://api.kunavo.com/v1, anahtar alanına da sk-kn- anahtarınızı girin. Amp bunu tüm biçimlerde Authorization: Bearer <key> olarak gönderir. Kunavo bu başlık üzerinden kimlik doğruladığı için Headers ve Query Parameters alanlarını boş bırakın.
  4. Model eşlemesini her satıra bir kalıp gelecek şekilde yazın. Sol taraf Amp'in standart model kimliğidir; -> işaretinden sonraki sağ taraf ise Kunavo'ya iletilen kimliktir. Bu iki yazım farklıdır (Amp openai/gpt-5.6-sol yazar, Kunavo ise gpt-5-6-sol kimliğine yanıt verir), bu nedenle burada ok işareti isteğe bağlı değildir. Standart kimlikleri ezberden yazmak yerine eklemek için Models seçicisini kullanın.
  5. Check Access'e basın. Eşleme geniş kapsamlı olduğunda Amp uç noktanın modellerini listeler; eşlemede tam olarak bir model adı varsa tek tokenlık bir istek gönderir. Ardından bağlantı listesinin altındaki yönlendirme grafiğinde Kunavo'nun eşlediğiniz modellere hizmet verdiğini, eşlemediğiniz her şeyin ise hâlâ Amp olarak göründüğünü doğrulayın.

Amp'in Model Routing belgeleri ile 21 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Amp'in kendi ücretleri ve bağlantının faturayı nereye taşıyıp nereye taşımadığı içindedir.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Amp içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliğiKunavo giriş / çıkışAmp içinde kullanım alanı
gpt-5-6-sol$2.00 / $12.00Medium modunun ana aracısı ve Amp'in varsayılan çalışma modeli Puck
gpt-6-astra$4.00 / $20.00High modunun ana aracısı ve çoğu modda Oracle alt aracısı
claude-fable-5-1$7.00 / $35.00Ultra modunun ana aracısı; zor ve ucu açık işler için ayrılmış model
gpt-5-6-terra$0.70 / $4.20Arama alt aracısı — hacmin belirleyici olduğu kod tabanı erişimi
claude-haiku-4-5$0.70 / $3.50Amp'in görseller, PDF'ler ve videolar için modeli View Media — Claude görselleri okur, videoları değil
Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Bağlantının taşımadığı ücretler

Model yönlendirme, token ücretini kimin faturalandırdığını değiştirir; başka hiçbir şeyi değiştirmez. Amp'in orb hesaplama kullanımı ayrı olarak ve dakika başına ölçülür, dolayısıyla bağlantı bu kalemi olduğu gibi bırakır. Web araması gibi model dışı araçlar da modeller nasıl yönlendirilirse yönlendirilsin Amp kredisi tüketmeye devam eder. Custom URL seçeneğinin kilidini açan Amp aboneliği, ilk token kullanılmadan önce ödenen sabit bir maliyettir.

Amp'in varsayılan olarak çalıştırdığı iki model, Kunavo'da bulunmadıkları için yukarıdaki tabloda yer almıyor: Low modunun arkasındaki GLM modelleri ve Read Thread alt aracısı. Bağlantı, Amp'in en ucuz hattını mevcut yapılandırmasıyla yeniden oluşturamaz; bu nedenle */* eşlemesi bu iki modeli sessizce Amp'te bırakır. Bu doğru sonuçtur, bir yapılandırma hatası değildir: Amp'in kendi kuralına göre hiçbir bağlantının hizmet vermediği her şeye Amp hizmet verir.

Sık sorulan sorular

Amp özel bir API uç noktası kullanabilir mi?

Evet, Model Routing bölümündeki Custom URL bağlantısı aracılığıyla; ancak her planda kullanılamaz. Amp'in Model Routing belgelerine göre, Custom URL'nin de içinde bulunduğu AI model yönlendiricileri ve ağ geçitleri deneysel aşamadadır ve yalnızca Megawatt, Gigawatt ve Enterprise müşterilerinin erken erişimine açıktır. Amp, bunları yakında herkese sunacağını belirtiyor ancak tarih vermiyor. 21 Eylül 2026 itibarıyla durum buydu. Hobby hesabındaki Add menüsü bu seçeneği hiç sunmaz; bu yüzden ilk kontrol etmeniz gereken temel URL değil, planınızdır.

Amp temel URL'sinin sonunda /v1 bulunması gerekir mi?

Seçtiğiniz API biçimine bağlıdır; bu alanın sık sık yanlış anlaşılmasının nedeni budur. chat-completions biçiminde Amp yalnızca /chat/completions ekler, bu nedenle temel URL /v1 kökü olmalıdır. Amp'in kendi belgelenmiş örneğinde https://api.example.com/v1, https://api.example.com/v1/chat/completions biçimine dönüşür. anthropic-messages biçiminde ise Amp bunun yerine /v1/messages ekler; dolayısıyla bu durumda yalnızca kök adres doğrudur. Amp ayrıca sonu zaten /v1 ile biten bir temel URL'nin kabul edildiğini ve son ekin iki kez eklenmediğini belirtir. Bağlantı formu da siz yazarken birleştirilmiş istek URL'sini gösterir; böylece kaydetmeden önce kontrol edebilirsiniz.

Amp özel uç nokta için API anahtarını nerede saklar?

Makinenizde değil, Amp'in sunucularında. Amp, çıkarım isteklerini kendi bulutundan yönlendirir; bu nedenle Custom URL bağlantısı yerel bir yapılandırma dosyasında veya ortam değişkeninde değil, hesap ayarlarınızın Model Routing bölümünde yapılandırılır. Belirttiğiniz uç noktaya Amp'in altyapısından erişilebilmesi gerekir. Amp, kimlik bilgisini üç API biçiminin tümünde Authorization: Bearer başlığı olarak gönderir. Amp'in yayımladığı CLI ayarları başvurusunda temel URL veya API anahtarı ayarı bulunmuyor; istemci tarafından bakıldığında da durum aynıdır.

Bağlantı ekledikten sonra Amp neden hâlâ kendi modellerini kullanıyor?

Çünkü bağlantı yalnızca eşlemesinde yer alan modellere hizmet verir; geri kalan her şeyi Amp kendisi sunar. Şu üç şeyi sırayla kontrol edin: bağlantının etkin olup olmadığını, öncelik listesinde nerede yer aldığını (önce kişisel bağlantılar, ardından çalışma alanı, sonra Amp; önce 0 önceliği denenir) ve model eşlemesinin gerçekten modunuzun çalıştırdığı modelle eşleşip eşleşmediğini. Bağlantı listesinin altındaki yönlendirme grafiği her modele hangi bağlantının hizmet verdiğini gösterir. amp config model-providers check-access --provider-model komutu kısa bir çıkarım isteği çalıştırır ve isteğe hangi bağlantının gerçekten hizmet verdiğini bildirir.

Kunavo, Amp'i kendi uç noktasında test etti mi?

Hayır. Kunavo, Amp'i çalışma zamanında test etmedi. Bu sayfa tamamlanmış bir oturumun raporu değil, 21 Eylül 2026'da okunan Amp'in kendi Model Routing belgelerinin aktarımıdır. Custom URL özelliği ücretli bir Amp planının arkasında olduğundan buradaki alanlar çalışan bir istemcide değil, Amp'in yayımlanmış teknik özelliklerinde kontrol edildi. Amp'in Check Access düğmesi sağlayıcıyla kimlik bilgisini doğrular ve yetkili testtir. Bu sayfadaki bir alan adı artık Amp'te gördüğünüzle eşleşmiyorsa esas alınması gereken Amp'in sayfasıdır.