Үргэлж үнэгүй.
Voxy
Үнэгүй эхлэх

API гарын авлага

Асинхрон ажил

Урт ажлууд дараалалд орж, jobId буцаана. Төлөвийг нь шалгаж эсвэл шууд сонсоно.

Ажил үүсгэдэг хаягууд#

ХаягАжлын төрөл
  • POST/stt/file
stt_file
  • POST/voices/clone
voice_clone
  • POST/batch
batch_tts
  • POST/sts
sts
  • POST/dubbing
  • POST/dubbing/{id}/render
dubbing
  • POST/tools/isolate
isolate
  • POST/projects/{id}/render
studio_render
  • POST/projects/{id}/export
export
Ажил дараалалд орж, ажиллаад, эдгээрийн яг нэгээр дуусна:

queued → running → succeeded (output-д үр дүн бий), эсвэл failed (error-д шалтгаан бий; дахин эхлүүлж болно), эсвэл canceled (та зогсоосон; дахин эхлүүлж болно).

Шалгах эсвэл сонсох#

Хамгийн энгийн нь GET /jobs/{id} 2–5 секунд тутамд. Шууд мэдэх бол GET /jobs/{id}/events (Server-Sent Events) нээнэ: эхлээд snapshot, дараа нь өөрчлөлт бүрт job үйл явдал, 15 секунд тутам ping ирнэ.

# Бичвэрт буулгах файл илгээхcurl https://voxy.mn/v1/stt/file \  -H "Authorization: Bearer $VOXY_API_KEY" \  -F [email protected] -F language=mn -F diarize=true# → {"transcriptId":"tr_…","jobId":"job_…"}# Ажлыг дагахcurl -N https://voxy.mn/v1/jobs/JOB_ID/events \  -H "Authorization: Bearer $VOXY_API_KEY"# Үр дүнг хадмал болгон татахcurl "https://voxy.mn/v1/transcripts/TRANSCRIPT_ID/export?format=srt" \  -H "Authorization: Bearer $VOXY_API_KEY" -o interview.srt

Ажлын объект#

GET /jobs/{id} болон SSE-ийн snapshot ижил хэлбэртэй. progress нь 0-ээс 1, output нь зөвхөн амжилттай дууссаны дараа ирнэ.

Хариу · 200
{  "id": "job_…",  "type": "stt_file",  "status": "succeeded",  "progress": 1,  "stage": null,  "title": "interview.mp3",  "error": null,  "output": { "transcriptId": "tr_…", "segments": 42, "durationSec": 318.4 },  "createdAt": "2026-11-14T09:12:03.000Z",  "updatedAt": "2026-11-14T09:13:41.000Z"}

Цуцлах ба дахин эхлүүлэх#

POST /jobs/{id}/cancel нь хүлээгдэж буй эсвэл ажиллаж буй ажлыг зогсооно. POST /jobs/{id}/retry нь амжилтгүй болсон эсвэл цуцалсан ажлыг дахин эхлүүлнэ. Бусад үед 409 буцаана.

Дууссан ажлын output талбарт үр дүнгийн холбоосууд байна (төрлөөс хамаарна). Холбоосууд гарын үсэгтэй, хэдэн цагийн дараа хүчингүй болно.

Хэлний дүрэм

Тайлбар нь монгол хэлээр. Код, талбарын нэр, API-н алдааны мессеж англи хэлээр, яг API-д байгаагаар.