AI Kullanım API'si

Bu uç noktalar kimliği doğrulanmış istemcinin kullanabileceği kullanım bilgilerini sunar. Sağlayıcı tanıları ve prompt önbelleği ayrıntıları operasyonel uygulama detaylarıdır ve kasıtlı olarak herkese açık dokümantasyona dahil edilmez.

Uç noktalar

Yöntem	Yol	Amaç	Kimlik doğrulama
GET	/ai/operations/rate-limit	Geçerli hesabın AI istek hakkını okuyun.	JWT + AI yetkisi
GET	/ai/operations/sessions/:sessionId/usage	Erişilebilir bir AI oturumunun token kullanımını okuyun.	JWT + AI yetkisi

GET /ai/operations/rate-limit

curl --fail-with-body "$BASE_URL/ai/operations/rate-limit" \
  -H "Authorization: Bearer $TOKEN"

Yanıt 200 OK

{
  "data": {
    "limit": 60,
    "remaining": 42,
    "resetsAt": "2026-10-01T10:01:00.000Z",
    "scope": "account"
  }
}

Sınırlar kimliği doğrulanmış hesaba bağlıdır ve değişebilir. Bir plan eşiğini sabit kodlamak yerine dönen değerleri kullanın.

GET /ai/operations/sessions/:sessionId/usage

Oturumlar API'sinin döndürdüğü bir oturum id değeri kullanın.

curl --fail-with-body "$BASE_URL/ai/operations/sessions/$SESSION_ID/usage" \
  -H "Authorization: Bearer $TOKEN"

Yanıt 200 OK

{
  "data": {
    "sessionId": "<session-uuid>",
    "totalInputTokens": 4250,
    "totalOutputTokens": 1823,
    "totalTokens": 6073,
    "estimatedCostUsd": 0.018,
    "runCount": 5
  }
}

Herkese açık tahmin hesaplanamadığında estimatedCostUsd değeri null olabilir.

Hatalar

Durum	Anlamı
401	Erişim tokenı eksik veya geçersiz.
403	Hesap gerekli yetkiye veya oturum erişimine sahip değil.
404	Oturum yok veya arayana görünür değil.
429	Arayan geçerli bir istek sınırını aştı.

Hatalar standart yanıt zarfını kullanır.