Asosiy mazmunga oʻtish

v2 va v3 dan v1 ga oʻting

/v1 API barcha mahsulotlarni saqlaydi, lekin yoʻllar, kalit yuboriladigan sarlavha, javob va xato tanalari hamda baʼzi maydon nomlari oʻzgaradi. Bu sahifada barcha oʻzgarishlar keltirilgan.

Nima oʻzgaradi

  • Barcha mahsulotlar bitta asosiy URL manzilga koʻchadi: https://my.neuronai.uz/api/v1.
  • Kalit X-Api-Key oʻrniga Authorization: Bearer da yuboriladi.
  • success endi yoʻq: JSON javobda data va request_id boʻladi, barcha xatolar esa oʻzgarmas kodli yagona shaklga ega.
  • Barcha maydon nomlari snake_case da yoziladi, vaqt belgilari esa Z bilan tugaydi.
  • Kalitlar faqat bir marta koʻrsatiladi va tanlangan mahsulotlar bilan cheklanishi mumkin. Mavjud kalitlaringiz toʻliq ruxsatga ega, shuning uchun ishlashda davom etadi.
  • Eski yoʻllar olib tashlandi va 404 bilan javob beradi. Kodingizni quyidagi yoʻllarga oʻtkazing.

Yoʻllar

Aksariyat yoʻllarda faqat versiya oʻzgaradi. Yoʻlda yana nima oʻzgargani izohlarda aytilgan.

AvvalHozir
POST /api/v3/tts/synthesizePOST /api/v1/tts/synthesize
POST /api/v3/tts/dialoguePOST /api/v1/tts/dialogue

Endi Idempotency-Key qabul qiladi.

POST /api/v3/tts/jobsPOST /api/v1/tts/jobs
GET /api/v3/tts/jobs/{id}GET /api/v1/tts/jobs/{id}
GET /api/v3/tts/jobs/{id}/audioGET /api/v1/tts/jobs/{id}/audio
GET /api/v3/tts/voicesGET /api/v1/tts/voices?type=stock

Roʻyxat sahifalab keladi: next_cursor boʻyicha davom eting.

GET /api/v3/tts/my-voicesGET /api/v1/tts/voices?type=custom

voices:read ruxsati kerak. Busiz roʻyxat boʻsh keladi.

POST /api/v3/tts/voicesPOST /api/v1/tts/voices

Endi Idempotency-Key qabul qiladi.

PUT /api/v3/tts/voices/{id}PATCH /api/v1/tts/voices/{id}

Faqat JSON. Faqat oʻzgaradigan maydonlarni yuboring.

POST /api/v3/tts/voices/{id} (_method=PUT)POST /api/v1/tts/voices/{id}/audio

Namunaviy audioni almashtiradi, _method maydoni kerak emas.

DELETE /api/v3/tts/voices/{id}DELETE /api/v1/tts/voices/{id}

Tanasiz 204 bilan javob beradi.

POST /api/v2/stt/transcribePOST /api/v1/stt/transcribe
GET /api/v2/user/balanceGET /api/v1/balance

Yangi tana: quyiga qarang.

GET /api/v1/balanceGET /api/v1/balance

Yangi tana: quyiga qarang.

GET /api/v1/usageGET /api/v1/usage

Yangi tana: quyiga qarang.

POST /api/v2/tts/synthesizePOST /api/v1/tts/synthesize

MP3 mexanizmi ishdan chiqarilgan: /v1 oʻz ovozlari bilan WAV sintez qiladi. voice_id ni /v1 roʻyxatidan tanlang.

GET /api/v2/tts/voicesGET /api/v1/tts/voices

MP3 mexanizmi ishdan chiqarilgan: /v1 oʻz ovozlari bilan WAV sintez qiladi. voice_id ni /v1 roʻyxatidan tanlang.

OpenAI va Cohere bilan mos endpointlar oʻz yoʻllari va muvaffaqiyatli javob tanalarini saqlaydi: /api/v1/chat/completions, /api/v1/models, /api/v1/embeddings, shuningdek /api/v1/rerank va uning Cohere uchun egizagi /api/v2/rerank. Faqat ularning xatolari quyida aytilganidek oʻzgaradi.

Autentifikatsiya

Har bir soʻrovda kalitni Authorization: Bearer nai_… sifatida yuboring; X-Api-Key endi hujjatlarda yoʻq. Ovozlar roʻyxatiga yuborilgan kalit endi tekshiriladi, shuning uchun notoʻgʻri kalit ommaviy roʻyxat oʻrniga 401 javobini oladi.

Javob tanalari

success olib tashlandi, chunki buni holat bildiradi. Koʻchirilgan endpointlarda obyekt data ichida, roʻyxat esa data ichida next_cursor bilan keladi va har bir shunday tanada request_id bor. Yaratish 201, navbatga qoʻyilgan vazifa Location bilan 202, oʻchirish esa tanasiz 204 bilan javob beradi.

Avval
{
  "success": true,
  "data": {
    "id": "01j9x3c5d6e7f8g9h0j1k2m3n4",
    "status": "succeeded",
    "createdAt": "2026-09-25T10:00:00+00:00",
    "characterCount": 42,
    "audioUrl": "https://my.neuronai.uz/api/v3/tts/jobs/01j9x3c5d6e7f8g9h0j1k2m3n4/audio"
  }
}

Hozir
{
  "data": {
    "id": "01j9x3c5d6e7f8g9h0j1k2m3n4",
    "status": "succeeded",
    "created_at": "2026-09-25T10:00:00Z",
    "character_count": 42,
    "audio_url": "https://my.neuronai.uz/api/v1/tts/jobs/01j9x3c5d6e7f8g9h0j1k2m3n4/audio"
  },
  "request_id": "0b8e8a5e-6f5c-4f7e-9d63-2c1f0f4b7a51"
}

Ovozlar roʻyxati sukut boʻyicha 50 tadan, limit bilan 100 tagacha sahifalarda keladi. Keyingi sahifa uchun oxirgi next_cursor ni cursor sifatida bering, toki next_cursor null boʻlmaguncha.

Xatolar

Endi har bir xato bitta tanaga ega: type, code, message va param maydonli error, soʻng request_id. Tekshiruv xatosi fields ni qoʻshadi, unda har bir maydonning birinchi xabari beriladi, avval esa errors ularning hammasini sanab oʻtardi. Qarorni xabar matniga emas, error.code ga qarab qabul qiling.

voice_id is not available for your account xabari oʻz soʻzlarini saqlaydi, lekin uning oʻrniga voice_unavailable kodini tekshiring.

Idempotency-Key ni boshqa tana bilan qayta ishlatish endi 409 idempotency_conflict javobini oladi. Eski yoʻllar esa birinchi javobni indamay qaytarardi.

OpenAI bilan mos endpointlarda xato obyektiga param va request_id qoʻshiladi, rad etilgan kalit esa sababini code da aytadi, masalan avval invalid_api_key boʻlgan joyda api_key_revoked.

Nomi oʻzgargan maydonlar

Barcha maydonlar snake_case da. Quyida oʻzgargan maydonlar.

Sintez vazifasi

AvvalHozir
createdAtcreated_at
startedAtstarted_at
finishedAtfinished_at
characterCountcharacter_count
balanceAfterbalance_after
voiceCustomvoice_custom
latencyMslatency_ms
referralRewardreferral_reward

/v1 da olib tashlandi. Taklif qilgan foydalanuvchiga toʻgʻridan-toʻgʻri xabar beriladi.

audioUrlaudio_url

/v1 audio endpointiga olib boradi.

Ovoz

AvvalHozir
refTextref_text
createdAtcreated_at
tagstags

Doim roʻyxat, hech qachon null emas.

type

Yangi maydon: stock yoki custom.

Transkripsiya

AvvalHozir
durationSecondsduration_seconds
requestIdrequest_id

data ichidan chiqarilib, uning yoniga qoʻyildi.

referralRewardreferral_reward

/v1 da olib tashlandi. Taklif qilgan foydalanuvchiga toʻgʻridan-toʻgʻri xabar beriladi.

Balans

AvvalHozir
sttPricePerSecondstt_price_per_second
ttsPricePerChartts_price_per_char
minTopupmin_topup

Sarf

AvvalHozir
by_key[].api_key_idby_key[].id

Kalitning ommaviy identifikatori yoki boshqaruv panelidan kelgan soʻrovlar uchun null.

period.startperiod.start

Endi days ta butun kunni oʻz ichiga oladi, bugun ham kiradi.

Vaqt belgilari UTC boʻyicha RFC 3339 formatida va avvalgi +00:00 oʻrniga Z bilan tugaydi.

Sarlavhalar

SarlavhaNima oʻzgardi
X-Request-Id
Har bir javobda bor. U doim joriy soʻrovni, jumladan takrorlanganini ham bildiradi.
X-Referral-Reward
/v1 da olib tashlandi. Taklif qilgan foydalanuvchiga toʻgʻridan-toʻgʻri xabar beriladi.
X-Audio-Url
Endi yuborilmaydi.
X-Character-CountX-BalanceX-Voice-Custom
Endi dialog javoblarida ham yuboriladi.
X-Turns
Kalitlar oʻsha, vaqt siljishlari esa doim kasr sonlar.
Idempotency-Replayed
Endi transkripsiya yoki ovoz yaratish takrorlanganda ham yuboriladi.

API kalitlar

Endi kalitlar faqat xesh sifatida saqlanadi, shuning uchun kalit bir marta, yaratilganda koʻrsatiladi va boshqa hech qachon koʻrsatilmaydi. Kalitni yoʻqotgan boʻlsangiz, yangisini yarating, ilovalaringizni unga oʻtkazing va eskisini chaqirib oling.

Ruxsatlar paydo boʻlishidan oldin yaratilgan barcha kalitlar toʻliq ruxsatga ega, shuning uchun hech narsa ishlashdan toʻxtamaydi. Yangi kalitlarga faqat kerakli mahsulotlarni bering.