GET /v1/balance

Bu salt okunur uç nokta, API anahtarını doğrular ancak pozitif bakiye gerektirmez.

Rica etmek

curl https://api.model-gate.com/v1/balance \
  -H "Authorization: Bearer mg_live_..."

Cevap

{
  "object": "balance",
  "currency": "USD",
  "balance": "12.3400000000"
}

Bireysel kimlik bilgileri için bakiye, anahtarın sahibi olan kullanıcıya aittir. İşletme kimlik bilgileri için API ücretleri her zaman şirket sahibinin cüzdanını kullanır. Paylaşılan şirket bakiyesi, yalnızca kimlik bilgisi sorumlusunun şirket düzeyinde bakiye görünürlüğüne (kuruluş sahibi, yönetici veya faturalandırma rolü) sahip olması durumunda döndürülür. Çalışan geliştirici/görüntüleyici kimlik bilgileri, izin verilen API isteklerini yürütebilir ancak HTTP 403'ü alabilir. /v1/balance; bu kullanıcılar kontrol panelinde yalnızca izin verilen grup kullanımlarını ve sınırlarını görürler. API anahtarı usage Ve spend_limit ayrı değerler olarak kalır.

Kimlik doğrulama hatası

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "invalid API key"
  }
}

İşletme izni hatası

{
  "error": {
    "type": "permission_error",
    "code": "balance_not_permitted",
    "message": "Company balance is not available for this credential principal."
  }
}