Хязгаар ба алдаа

Хурдны хязгаар#

Түлхүүр бүр минутад 60 хүсэлт. Хариу бүрт дараах толгойнууд ирнэ:

Нэг бүртгэл GPU дээр зэрэг 2 хүсэлт ажиллуулна; илүү нь дараалалд орно. Дараалал дүүрвэл 429 rate_limited буцаана.

Өдрийн хязгаар#

Апп болон API нэг өдрийн хязгаарыг хуваалцана. Шөнийн 00:00 UTC-д шинэчлэгдэнэ. Одоогийн хэрэглээг GET /usage-ээр харна. Илүү хэрэгтэй бол бидэнд бичээрэй.

• tts

  50,000 тэмдэгт
  Текстээс яриа: илгээсэн тэмдэгт × хувилбар
• stt

  4 цаг
  Бичвэрт буулгах, шууд бичвэр: аудионы урт
• sts

  30 минут
  Дуу хувиргагч: аудионы урт
• dubbing

  1 цаг
  Дуу оруулалт: эх бичлэгийн урт
• agent

  1 цаг
  Дуут агенттай ярьсан хугацаа (хүрээ нь agents)
• clone

  10 удаа
  Дуу хоолой хуулах оролдлого
• design

  30 удаа
  Тайлбараас дуу хоолой зохиох
• dictation

  2 цаг
  Яриагаар бичих: ?source=dictation
• tools

  2 цаг
  Аудио хэрэгсэл: дуу ялгах гэх мэт

Алдаа#

Алдаа бүр ижил JSON хэлбэртэй. Програмаа code талбараар салаалуулна уу: энэ нь тогтвортой. message нь хүнд зориулсан англи тайлбар бөгөөд үг нь өөрчлөгдөж болно.

{  "error": {    "code": "limit_reached",    "message": "You've reached today's tts limit. It resets at midnight UTC.",    "details": {      "feature": "tts",      "used": 50000,      "limit": 50000,      "resetAt": "2026-11-15T00:00:00.000Z"    }  }}

• 401unauthorized

  Үгүй
  Түлхүүр алга, буруу, хүчингүй эсвэл хугацаа нь дууссан.
• 403forbidden

  Үгүй
  Бүртгэл түдгэлзсэн, API эрх идэвхгүй, эсвэл түлхүүрт хүрээ дутуу.
• 404not_found

  Үгүй
  Ийм нөөц эсвэл хаяг алга, эсвэл таных биш.
• 409conflict

  Үгүй
  Одоогийн төлөвт хийх боломжгүй (жишээ нь дууссан ажлыг цуцлах).
• 413validation

  Үгүй
  Файл хэт том (600 MB хүртэл; хаяг бүр аудионы уртыг бас хязгаарлана).
• 422validation

  Үгүй
  Оролт буруу. details-д алдаануудын жагсаалт байна.
• 429rate_limited

  Тийм · Retry-After
  Минутын хүсэлтийн хязгаар эсвэл GPU дараалал дүүрсэн.
• 429limit_reached

  resetAt хүртэл
  Өдрийн хязгаар дууссан. details-д feature, used, limit, resetAt байна.
• 502 / 504upstream_error

  Тийм
  Загварын сервер алдаа өгсөн эсвэл хугацаа хэтэрсэн.
• 503model_unavailable

  Тийм
  Загвар түр ажиллахгүй байна (жишээ нь сургалтын үеэр).

Дахин оролдох бол экспоненциал хүлээлт (1 с, 2 с, 4 с…) ашиглаж, Retry-After-ийг дагана уу. Бусад 4xx дахин оролдоход амжилттай болохгүй.

429-ийг зөв барих#

Retry-After байвал түүнийг дагаж хүлээнэ, байхгүй бол хүлээлтээ хоёр дахин уртасгана. limit_reached бол өдрийн хязгаар дууссан тул details.resetAt хүртэл зогсооно.

# --retry нь 429 болон 503 үед Retry-After-ийг дагаж дахин оролдоноcurl --retry 4 https://voxy.mn/v1/voices \  -H "Authorization: Bearer $VOXY_API_KEY"

Хувилбар ба өөрчлөлт#

/v1 дотор зөвхөн нэмэлт өөрчлөлт (шинэ хаяг, шинэ заавал биш талбар) хийнэ. Талбар хасах, нэр солих зэрэг эвдэх өөрчлөлтийг урьдчилан имэйлээр мэдэгдэж, Deprecation болон Sunset толгойгоор тэмдэглэнэ. Мэдэгдэхгүй JSON талбарыг үл тоомсорлох байдлаар кодоо бичээрэй.