Bakiye API'si

Ne kadar kredi harcayabileceğinizi ve bunların ne kadarının bir sonraki aylık yenilemede süresinin dolacağını kontrol edin.

GET/openapi/v1/balance

Bakiyeyi al

API anahtarının sahibi olan hesabın kredi bakiyesini döndürür. Paylaşılan bir kredi havuzuna sahip bir takımda, değerler havuza ait olan değerlerdir. Bu uç noktayı çağırmak ücretsizdir.

Request

GET

/openapi/v1/balance

curl https://api.meshy.ai/openapi/v1/balance \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "balance": 1000,
  "monthly_credits": 600,
  "permanent_credits": 400,
  "monthly_resets_at": 1793491200000
}

Dönüş değerleri

Name
balance
Type
integer
Description
Harcayabileceğiniz kredi sayısı. Genellikle monthly_credits artı permanent_credits değerine eşittir.
Sizin için bir üye kredi limiti veya bir Enterprise çalışma alanı kredi limiti geçerliyse bu değer daha düşük olabilir. Takım sahiplerinin ve yöneticilerinin böyle bir limiti yoktur.
Name
monthly_credits
Type
integer
Description
monthly_resets_at tarihinde gerçekleşecek bir sonraki aylık yenilemede süresi dolacak olan kalan kredi sayısı.
Name
permanent_credits
Type
integer
Description
Süresi dolmayan kredi sayısı; örneğin satın aldığınız kredi paketlerinden ve ödüllerden gelenler.
Name
monthly_resets_at
Type
timestamp
Description
Unix milisaniye cinsinden bir sonraki aylık kredi yenileme zamanı. Bu zamanda, kalan aylık krediler sona erer ve aktif bir abonelik bunları yeniden doldurur. Planlanmış bir yenileme yoksa null değerini alır.

Hata durumları

Name
401 - Unauthorized
Description
API anahtarı eksik veya geçersiz. Authorization başlığını kontrol edin.
Name
429 - Too Many Requests
Description
Çok fazla istek gönderdiniz. Retry-After içindeki saniye sayısı kadar bekleyin, ardından tekrar deneyin.