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

Хөгжүүлэгчид · REST ба WebSocket

Voxy API

Апп дахь бүх боломж (текстээс яриа, дуу хоолой хуулах, зохиох, бичвэрт буулгах, дуу оруулалт, Студи, дуут агент) REST болон WebSocket API-аар. Монгол хэлийг тэргүүнд ээлжинд.

API эрх зөвшөөрлөөр олгогдоно

Баримт бичиг нийтэд нээлттэй. Түлхүүр авахын тулд юу бүтээж буйгаа бичээд хүсэлт гаргана; ихэвчлэн ажлын хоёр өдрийн дотор хариулна.

Үндсэн хаяг#

Үндсэн хаяг
https://voxy.mn/v1

Бүх хүсэлт Authorization: Bearer vs_live_… толгойтой байна. Хариу нь JSON (стрим, аудио файлаас бусад). Цаг нь ISO 8601, UTC.

Хурдан эхлэх#

  1. 1Тохиргоо → API хэсэгт хүсэлт гаргана. Бид хянаад имэйлээр хариулна.
  2. 2Зөвшөөрөгдсөний дараа түлхүүр үүсгэж, серверийнхээ VOXY_API_KEY орчны хувьсагчид хадгална.
  3. 3Түлхүүрээ шалгана:
curl https://voxy.mn/v1/me \  -H "Authorization: Bearer $VOXY_API_KEY"

Анхны яриагаа үүсгэх#

Дуу хоолойгоо сонгоод POST /tts/stream. Хариу нь мөр бүрт нэг JSON үйл явдалтай NDJSON стрим. Сүүлийн done үйл явдалд бүтэн WAV файлын audioUrl байна.

# 1. Дуу хоолой сонгохcurl "https://voxy.mn/v1/voices?scope=studio" \  -H "Authorization: Bearer $VOXY_API_KEY"# 2. Яриа үүсгэх (NDJSON стрим; сүүлийн мөрөнд audioUrl бий)curl -N https://voxy.mn/v1/tts/stream \  -H "Authorization: Bearer $VOXY_API_KEY" \  -H "Content-Type: application/json" \  -d '{"text":"Сайн байна уу? Энэ бол Voxy.","voiceId":"VOICE_ID","language":"mn"}'

Файлын холбоос нь гарын үсэгтэй, хэдэн цагийн дараа хүчингүй болно. Удаан хадгалах бол файлыг татаж аваарай, эсвэл GET /history/{id}/download?format=mp3 хаягаас дахин татна уу.

Боломжууд#

  • Текстээс яриа
    Хүрээ
    tts
    Хаягууд
    POST /tts/stream, POST /tts/check
  • Дуу хоолой: жагсаах, хуулах, зохиох, нийтлэх
    Хүрээ
    voices
    Хаягууд
    GET /voices, POST /voices/clone, POST /voices/design
  • Бичвэрт буулгах, шууд бичвэр, яриагаар бичих
    Хүрээ
    stt
    Хаягууд
    POST /stt/file, GET /stt/live (WS), /transcripts
  • Студи: аудио ном, подкаст
    Хүрээ
    studio
    Хаягууд
    /projects, /chapters, /blocks
  • Дуу оруулалт
    Хүрээ
    dubbing
    Хаягууд
    /dubbing
  • Багц яриа, дуу хувиргагч, аудио хэрэгсэл
    Хүрээ
    media
    Хаягууд
    POST /batch, POST /sts, /tools/*
  • Дуут агент
    Хүрээ
    agents
    Хаягууд
    /agents, GET /agents/{id}/talk (WS)
  • Дуудлагын толь
    Хүрээ
    dictionaries
    Хаягууд
    /dictionaries
  • Түүх, татах
    Хүрээ
    history
    Хаягууд
    /history
  • Асинхрон ажил
    Хүрээ
    бүх түлхүүр
    Хаягууд
    /jobs

Гарын авлагууд#

Хэлний дүрэм

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