Dokümanlar

Tek anahtar tüm uç noktalarda ve tüm modellerde geçerli. Hangi Base URL'yi gireceğin, aracının /v1'i kendisi ekleyip eklemediğine bağlı.

Başlıklar (headers)

Anahtarını gizli tut: yalnızca kendi sunucunda veya kendi araçlarında kullan; tarayıcı koduna ya da herkese açık depolara koyma. Anahtar sızarsa konsoldan sil ve yenisini oluştur.

Tüm yollar https://api.llmpass.app adresine göredir.

Diğer uç noktalar (embeddings, görsel, ses) sunulmuyor.

Modelleri listele

curl https://api.llmpass.app/v1/models \
  -H "Authorization: Bearer sk-XXXXXXXXXXXXXXXX"

Token say

curl https://api.llmpass.app/v1/messages/count_tokens \
  -H "x-api-key: sk-XXXXXXXXXXXXXXXX" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"Merhaba"}]}'

Yanıtı server-sent events (SSE) olarak almak için "stream": true gönder. Olaylar çağırdığın uç noktanın biçimindedir: /v1/messages'ta message_start, content_block_delta … message_stop; /v1/chat/completions'ta data: [DONE] ile biten data: parçaları.

Stream edilen istekler de diğerleri gibi kullanılan token kadar ücretlendirilir. Uzun çıktılarda streaming'i tercih et: ilerlemeyi hemen görürsün ve bağlantı aktif kalır.

curl -N https://api.llmpass.app/v1/messages \
  -H "x-api-key: sk-XXXXXXXXXXXXXXXX" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":256,"stream":true,"messages":[{"role":"user","content":"Merhaba"}]}'

Hatalar okunabilir bir mesajla JSON olarak döner. Başarısız istekler asla ücretlendirilmez.

Yetersiz bakiye genelde 402 olarak döner; bazı uç noktalar insufficient_user_quota koduyla 403 döndürür. Hata mesajı durumu açıklar ve cüzdan sayfasına bağlantı verir.

Hata biçimi

Biçim, çağırdığın uç noktaya göre değişir:

{
  "type": "error",
  "error": {
    "type": "…",
    "message": "…"
  }
}

Destekle iletişime geçerken isteğin zamanını ve konsol loglarındaki request ID'yi ekle.

• Sabit bir dakika başı istek kotası yayımlamıyoruz. 429 alırsan üstel geri çekilmeyle tekrar dene; sürekli yüksek hacim için destekle iletişime geç.
• Tek bir istek en fazla 15 dakika sürebilir.
• Streaming sırasında 5 dakika boyunca hiç veri gelmezse bağlantı kapatılır.
• Token sayma uç noktası IP adresi başına dakikada 120 isteğe izin verir.
• Konsolda bir anahtara koyduğun limitler (harcama limiti, son kullanma tarihi, izinli modeller ve IP'ler) bunlara ek olarak uygulanır.

• Bakiyen konsolda Türk lirası olarak gösterilir. Önce bakiye yüklersin; abonelik ya da aylık ücret yok.
• Bakiyeyi TL ile yüklersin; kur, yükleme anında sabitlenir.
• Her isteğin maliyeti, girdi, çıktı, önbellek okuma ve önbellek yazma token sayılarının model listesindeki fiyatlarla çarpılmasıyla hesaplanır.
• Başarısız istekler asla ücretlendirilmez.
• Önce deneme kredisi, sonra satın aldığın bakiye harcanır.
• Deneme kredisindeyken yalnızca deneme modelleri açıktır; ilk yüklemeyle tüm modeller açılır.
• Ücretsiz deneme kredisi otomatik tanımlanmaz: kullanıcı adınla Telegram destek hattımıza yaz.
• Kullanılmamış satın alınmış bakiye iade edilir; deneme kredisi iade edilmez.
• Her istek, token sayıları ve maliyetiyle birlikte konsoldaki loglarda görünür.