Skip to content

4. Balansni tekshirish (Get Balance)

Balansni tekshirish

Hisob balansini ko'rish uchun API kalitingizni kiriting.

Endpoint

GET /api/v1/get-balance

Tavsif

Bu endpoint orqali hisob balansingizni turli formatlarda tekshirishingiz mumkin. Balans qiymati, Speech-to-Text uchun taxminiy audio davomiyligi va tarjima uchun taxminiy belgilar soni ko'rsatiladi.

So'rov parametrlari

Bu endpoint uchun parametrlar talab qilinmaydi.

Sarlavhalar

Sarlavha Qiymat Tavsif
Authorization Bearer <api-key> Autentifikatsiya uchun API kalitingiz

So'rov namunasi

curl -X GET "https://developer.kotib.ai/api/v1/get-balance" \
-H "Authorization: Bearer <api-key>"

Javob namunasi

{
  "balance": "8685",
  "balance_as_duration": "~9m 39s",
  "balance_as_translation": "~45,770 chars"
}

Javob maydonlari

Maydon Tur Tavsif
balance string Balans qiymati (masalan, "8685")
balance_as_duration string Audio davomiyligiga aylantirilgan balans (masalan, "~9m 39s")
balance_as_translation string Tarjima uchun belgilar soniga aylantirilgan balans (masalan, "~45,770 chars")

Balans formatlarini tushunish

Balans qiymati

balance maydoni hisob kreditlarini ifodalovchi son qiymatini ko'rsatadi. Bu barcha API operatsiyalari uchun asosiy birlik.

Audio davomiyligi formati

balance_as_duration maydoni balansingizni taxminiy audio qayta ishlash vaqtiga aylantiradi. Bu Speech-to-Text operatsiyalarini rejalashtirish uchun foydali:

  • Misol: "~9m 39s" — taxminan 9 daqiqa 39 soniya audio qayta ishlash mumkin
  • Foydalanish: Audio fayllar uchun STT so'rovlarini rejalashtirish

Tarjima belgilar soni

balance_as_translation maydoni balansingizni tarjima uchun taxminiy belgilar soniga aylantiradi:

  • Misol: "~45,770 chars" — taxminan 45,770 belgi tarjima qilish mumkin
  • Foydalanish: Matn tarjimasi so'rovlarini rejalashtirish

Xato javoblari

Noto'g'ri API kalit

{
  "error": "Invalid API key"
}

So'rovlar cheklovi oshdi

{
  "error": "Rate limit exceeded"
}

Server xatosi

{
  "error": "Internal server error"
}

HTTP status kodlari

Status kodi Tavsif
200 Muvaffaqiyat — Balans muvaffaqiyatli olindi
401 Ruxsat yo'q — Noto'g'ri yoki yo'q API kalit
429 So'rovlar ko'p — So'rovlar cheklovi oshdi
500 Ichki server xatosi — Xatolik yuz berdi

Foydalanish misollari

So'rov yuborishdan oldin balansni tekshirish

# Check balance before processing audio
curl -X GET "https://developer.kotib.ai/api/v1/get-balance" \
-H "Authorization: Bearer <api-key>"

# Extract balance information
response=$(curl -s -X GET "https://developer.kotib.ai/api/v1/get-balance" \
-H "Authorization: Bearer <api-key>")

# Parse balance values
balance=$(echo $response | jq -r '.balance')
duration=$(echo $response | jq -r '.balance_as_duration')
chars=$(echo $response | jq -r '.balance_as_translation')

echo "Balance: $balance"
echo "Audio Duration: $duration"
echo "Translation: $chars"

Balans foydalanishini kuzatish

# Check balance and display in different formats
response=$(curl -s -X GET "https://developer.kotib.ai/api/v1/get-balance" \
-H "Authorization: Bearer <api-key>")

# Display formatted balance information
echo "=== Account Balance ==="
echo "Raw Balance: $(echo $response | jq -r '.balance')"
echo "Audio Time: $(echo $response | jq -r '.balance_as_duration')"
echo "Text Length: $(echo $response | jq -r '.balance_as_translation')"

Eng yaxshi amaliyotlar

  1. Balansni muntazam tekshiring: Katta so'rovlar yuborishdan oldin balansingizni kuzating
  2. Balans formatlarini tushuning: Foydalanish holatiga mos formatdan foydalaning (qiymat, davomiylik yoki belgilar soni)
  3. Xatolarni to'g'ri boshqaring: Har doim xato javoblarini tekshiring
  4. Foydalanishni rejalashtiring: API chaqiruvlarini rejalashtirishda audio davomiyligi va matn uzunligini hisobga oling
  5. Sarfni kuzating: Turli xil so'rovlar bilan balansingiz qanday kamayishini kuzating

Amaliy misollar

Misol 1: STT so'rovini rejalashtirish

# Check balance
response=$(curl -s -X GET "https://developer.kotib.ai/api/v1/get-balance" \
-H "Authorization: Bearer <api-key>")

duration=$(echo $response | jq -r '.balance_as_duration')
echo "You can process: $duration of audio"

# If you have a 5-minute audio file
if [[ "$duration" =~ ([0-9]+)m ]]; then
  available_minutes=${BASH_REMATCH[1]}
  if [ "$available_minutes" -ge 5 ]; then
    echo "Sufficient balance for 5-minute audio file"
  else
    echo "Insufficient balance for 5-minute audio file"
  fi
fi

Misol 2: Tarjima so'rovini rejalashtirish

# Check balance
response=$(curl -s -X GET "https://developer.kotib.ai/api/v1/get-balance" \
-H "Authorization: Bearer <api-key>")

chars=$(echo $response | jq -r '.balance_as_translation')
echo "You can translate: $chars"

# If you have a 1000-character text
if [[ "$chars" =~ ([0-9,]+) ]]; then
  available_chars=$(echo ${BASH_REMATCH[1]} | tr -d ',')
  if [ "$available_chars" -ge 1000 ]; then
    echo "Sufficient balance for 1000-character text"
  else
    echo "Insufficient balance for 1000-character text"
  fi
fi

Tezkor navigatsiya

- ← Oldingi: Get Status | Keyingi: Webhooks →

- ← Bosh sahifaga