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

Эрх ба түлхүүр

API-г хэн, хэрхэн ашиглах, түлхүүрээ хэрхэн хамгаалах вэ.

Эрх хүсэх#

GPU хүчин чадал хязгаартай тул API эрхийг хүн хянаж олгодог. Бүртгэлтэй хэрэглэгч бүр Тохиргоо → API хэсгээс юу бүтээж буйгаа бичиж хүсэлт гаргана. Ихэвчлэн ажлын хоёр өдрийн дотор имэйлээр хариулна.

Татгалзсан эсвэл эрх нь хаагдсан бол илүү дэлгэрэнгүй мэдээлэлтэйгээр дахин хүсэлт гаргаж болно. Эрхийг хаахад тухайн бүртгэлийн бүх түлхүүр шууд ажиллахаа больдог.

Хүсэлт гаргахад бэлэн үү?

Товч таныг Тохиргоо → API руу аваачна. Нэвтрээгүй бол эхлээд нэвтэрч, дараа нь шууд тэнд очно.

Хандалт хүсэх

Түлхүүр#

Хэлбэр. Түлхүүр vs_live_… хэлбэртэй. Бид зөвхөн хамгаалсан хэлбэрийг нь хадгалдаг тул бүтэн түлхүүр зөвхөн үүсгэх үед нэг удаа харагдана.
Тоо. Нэг бүртгэлд хамгийн ихдээ 10 идэвхтэй түлхүүр. Орчин бүрт (production, staging) тусдаа түлхүүр ашиглаарай.
Хугацаа. 30, 90 эсвэл 365 хоногоор тохируулж болно. Хугацаа дууссан түлхүүр 401 буцаана.
Хэний нэрээр. Түлхүүр таны нэрийн өмнөөс ажиллана: таны дуу хоолой, төсөл, түүхэд хандана, хэрэглээ таны өдрийн хязгаараас хасагдана.

Түлхүүрийг зөвхөн серверт хадгална

/v1 нь CORS зөвшөөрдөггүй тул хөтчөөс шууд дуудах боломжгүй, түлхүүрийг клиент кодонд бүү оруул. Хөтчөөс шууд WebSocket холбох шаардлагатай бол серверээсээ нэг удаагийн тасалбар үүсгэнэ (Стриминг хэсгийг үзнэ үү).

Эрхийн хүрээ#

Түлхүүр бүр зөвхөн сонгосон боломжуудад хандана. Шаардлагатай хүрээгүй түлхүүр 403 forbidden авна. /me, /usage, /jobs болон /realtime/tickets бүх түлхүүрт нээлттэй.

Хүрээ	Юуг нээх
`voices`	Дуу хоолой харах, хуулах, зохиох, баталгаажуулах, нийтлэх
`tts`	Текстээс яриа
`stt`	Бичвэрт буулгах, шууд яриа таних, яриагаар бичих
`studio`	Студийн төсөл, бүлэг, хувилбар, бэлэн бичлэг
`dubbing`	Дуу оруулалт
`media`	Багц яриа, дуу хувиргагч, аудио хэрэгсэл
`agents`	Дуут агент, харилцан яриа
`dictionaries`	Дуудлагын толь
`history`	Үүсгэсэн түүх, татаж авах

Түлхүүр солих#

1Шинэ түлхүүр үүсгэнэ.
2Серверээ шинэ түлхүүрээр шинэчилж байршуулна.
3Тохиргоо → API хэсгийн «Сүүлд ашигласан» баганаар хуучин түлхүүр ашиглагдахаа больсныг шалгаад хүчингүй болгоно.

Хуучин түлхүүрийн «Сүүлд ашигласан» хөдлөхөө больсон бол серверүүд шинэ түлхүүр рүү шилжсэн гэсэн үг. Одоо хүчингүй болгоход аюулгүй.

Алдагдсан бол

Шууд хүчингүй болгоорой; хүчингүй болгосон түлхүүр тэр даруй 401 буцаана.

Нөхцөл#

API ашиглалт Үйлчилгээний нөхцөл болон Зөвшөөрөгдөх хэрэглээний бодлого-д хамаарна. Ялангуяа хүний дууг зөвхөн эзний зөвшөөрөлтэйгөөр хуулна.

Түлхүүртэй болсон бол дараагийн алхам: хязгаар ба алдааг уншаад, анхны яриагаа үүсгээрэй.

Хэлний дүрэм

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