voice
Giọng đọc AI Đa năng (248 giọng) — Kho 248 giọng đọc AI chọn lọc (56 giọng Việt truyền cảm + 12 ngôn ngữ), hỗ trợ kịch bản dài tới 100.000 ký tự và chèn nhịp nghỉ [delay=1.5s].
Bảng giá API chi tiết theo từng cấu hình tham số
Đơn giá thực tế (VNĐ) trừ vào ví khi gọi POST /v1/generations (hoặc kiểm tra trước qua POST /v1/generations/estimate).
Input — tham số đầu vào
/v1/generationsGửi JSON gồm "model": "voice" và các tham số dưới đây ở cùng cấp. Tham số không có trong bảng sẽ bị từ chối (400).
| Tham số | Kiểu | Giá trị hỗ trợ | Mô tả |
|---|---|---|---|
modelrequired | string | voice | Mã model |
voicerequired | enum | Ngọc HuyềnmhsL3CPLxmLYdSTKp3GANz5r2MVjMfzwsSDzTpaLjbY9Minh ĐứcPhạm TuyênThái SơnThanh BìnhTrúc LyNgọc LinhĐoan TrangMai AnhThục ĐoanMinh TriếtThùy DungQuang SơnNgọc TrânMỹ DuyênQuỳnh AnhĐức TríKim ThanhAdamsRKkPtKD8vXn4bcHeKnTx4exL3q6oLZ38WU45C1NbQfo2de11VT3Uiqr7uH4B9KXrV9nG3pdnuAcaJpzwkztYXVF7HLX11t8HSEC9wB1DxtZD94bDecfJBUVsrpRXenT4KfR6o2ZzQsSP57cciZQBUUxrknCuPmZ5qY9D1QpQY8GG7Sb2JAY8GgE64rtyEWd9n9zV87wXjkzzqLsVtyV9hwYzhw3csGJdb8XVAVfjRx5tq5hNTq9yWrbRJRzNPoRQQUwGMPtrgY7uPB3pBR4d9hDtZwqUWc9LtbSaCAAbjaw178YfurQcmm8nLU69YVtgUVR9AKyYN8u9DrdA24ZsGgFoUge7AUVsEqCT3Hajd9XHgxcM3e2cLkH4VU5FDB7WP9enms15Sy7sCF6RqKWMq6icxQ4JqgFp3bZwdVNqRw9SAifQhJTifqGdm2qkaSTEq7T8DtNHaGP1u2fASNMp9k72Q2D9ZvJmWa1cRFZDddwScw1zqvXTxnZsxsa9sS3hNxoX5T6J5r4izSRr4hTEUjaqbFPS2C43qA8wbhsE6ndCPQsyeqyMPV5gH7mdcpgHUxy1PQPQKMMGPwq5dgUEue5eZEKLx1VX1dZzjqktBt53MRcgqeYarga2JdQyceL2TNmHdnDjeFWqAu5ntJUx3E7LyXxQ77FWFKjd44mEGxdAn31oFqfo1o3aUGE14as2kSruUjeZABkK725zWouya1rNxkgsutM7DrUHZT4j8CQgt5WWexB8rmVUBukYDFH3B7rMUByEtjktExEvVw9n8hUjQhKABCZ2B7L4zncWcNb4Q4cVrzyhHkh4Bxy16qtZcNvnPP56KaQbZgMz1ue1jFCagqFeSMpoHP3ZhoDwXbe1354hUJaV4ijMC3oLYQEHygPJtkrmBrx3X4aXsomBEyNjWq7tkHEebnDSwpr49AeT7egHZtkHEebnDSwpr49AeT7egHT7idd8r5DBSfrZ4zsvbG25J5ZsmEgM69V3DNJy6V1WP841SsfoG1YYcbQvUqMwGTQqYjxi5G3hB4tCcttV4h7fCGVoPp6wWKH6DyMALAgFVi5EEoviBGQ6SjQBK3TEbauLAX8mhhesqkCvtmFWjhbeLiEhMxhxaaRV2jMhQ74w9g1kkALaHmAYgAtS1R5cy4ZB6R43mjPU7MZkDDDtLANb79aszsDaAkjfZubKr4KY6PrcWiKYZpbuNxb49u6SFJde7626RzY1N5gZbZSBmFkBSbaHKxq1zhKHXND5SU1srscKrYiUHFYqFeSMpoHP4ZhoDwXbe135473108357809113272307841021926326557576643157468991943139527974828335919267746415552962293870capcut:BV421_vivn_streamingcapcut:vi_female_huongcapcut:vi-VN-HoaiMyNeuralcapcut:vi-VN-NamMinhNeuralcapcut:BV562_streamingcapcut:BV560_streamingcapcut:BV074_streamingcapcut:BV075_streamingcapcut:BV074_streaming_dspcapcut:BV075_streaming_vibrato_dspcapcut:BV075_streaming_demon_dspcapcut:BV075_streaming_robot_dspcapcut:ICL_en_male_henry1capcut:ICL_en_female_ericacapcut:ICL_en_male_attenboroughcapcut:ICL_en_male_cumberbatch2capcut:ICL_en_male_terrellcapcut:ICL_en_male_cc_rafaelcapcut:ICL_en_male_alastorcapcut:ICL_en_male_severuscapcut:ICL_en_female_cmcapcut:ICL_en_male_grinch2capcut:ICL_en_male_kevin2capcut:ICL_en_male_conductor1capcut:ICL_en_male_oogie2capcut:ICL_en_male_frosty1capcut:ICL_en_male_zaynecapcut:ICL_en_male_xavier1capcut:ICL_en_male_syluscapcut:ICL_en_female_chamberlaincapcut:ICL_en_male_cumberbatch1capcut:ICL_en_female_blanchettcapcut:ICL_en_male_henry2capcut:ICL_en_male_benjamin1capcut:ICL_en_male_benjamin2capcut:ICL_en_male_cc_lichcapcut:ICL_en_male_cc_draculacapcut:ICL_en_female_cc_bluetoothcapcut:ICL_en_male_cc_pennycapcut:ICL_en_female_cc_megancapcut:ICL_en_male_cc_jigsawcapcut:ICL_en_male_cc_chuckycapcut:ICL_en_male_cc_ghostface4capcut:ICL_en_male_aussiecapcut:ICL_en_male_poetrycapcut:ICL_2206985c8bf6capcut:ICL_en_female_guanggaocapcut:ICL_en_female_jiaoaocapcut:ICL_en_male_matthewcapcut:BV516_streamingcapcut:BV504_streamingcapcut:BV503_streamingcapcut:BV502_streamingcapcut:BV027_streamingcapcut:BV510_streamingcapcut:BV138_streamingcapcut:BV127_streamingcapcut:BV505_streamingcapcut:BV031_streamingcapcut:ICL_en_male_callumcapcut:ICL_en_male_drywcapcut:ICL_en_male_georgecapcut:BV506_streamingcapcut:BV507_streamingcapcut:BV072_streamingcapcut:BV192_streamingcapcut:BV191_streamingcapcut:BV540_streamingcapcut:BV190_streamingcapcut:BV164_streamingcapcut:BV162_streamingcapcut:BV161_streamingcapcut:BV160_streamingcapcut:ICL_id_male_uncle_hendracapcut:ICL_id_female_grandma_siticapcut:ICL_id_female_hantuperempuancapcut:BV541_streamingcapcut:ICL_id_female_jannah_happycapcut:ICL_id_male_sadcapcut:ICL_id_male_scaredcapcut:ICL_id_male_grandpa_sumarnocapcut:ICL_id_male_boy_budicapcut:ICL_id_female_girl_dewicapcut:ICL_id_female_sickweakcapcut:ICL_id_female_icecold_kartikacapcut:ICL_es_male_barneycapcut:ICL_es_male_elmocapcut:ICL_es_female_dianpocapcut:ICL_es_male_doradocapcut:ICL_es_female_tt_MarianaFcapcut:ICL_es_male_tt_GerardoQcapcut:ICL_es_male_tt_JuanZcapcut:ICL_es_male_tt_JuanJcapcut:ICL_es_male_tt_JonnieVvcapcut:ICL_es_male_tt_EmanuelAcapcut:ICL_mx_female_tt_carolacapcut:ICL_es_female_dianyingpeiyincapcut:ICL_es_male_cixingcapcut:ICL_es_male_taicicapcut:BV062_streamingcapcut:ICL_es_female_tt_AzulBcapcut:ICL_es_male_tt_GerardoFCPcapcut:ICL_es_female_tt_RosaWcapcut:ICL_es_female_tt_Vivicapcut:ICL_br_male_208M_VitorC2capcut:ICL_br_female_217V_MichelleMcapcut:ICL_br_male_207M_RodrigoA2capcut:ICL_br_female_218F_GracianaCcapcut:ICL_br_male_201M_CaioScapcut:ICL_br_male_206M_VitorC1capcut:ICL_br_male_210M_AlexNcapcut:ICL_br_male_204M_RodrigoA1capcut:BV531_streamingcapcut:BV530_streamingcapcut:ICL_br_male_202M_EduardoScapcut:ICL_ja_female_laopopocapcut:ICL_jp_male_kenancapcut:ICL_jp_female_tt_youcapcut:ICL_jp_female_jidongshaonvcapcut:ICL_ja_female_kuaizui02capcut:ICL_ja_female_shuanglangcapcut:ICL_ja_male_gaoxiaocapcut:ICL_ja_male_gaoxiao02capcut:BV428_streamingcapcut:BV701_streamingcapcut:BV411_streamingcapcut:BV007_streamingcapcut:BV405_streamingcapcut:BV408_streamingcapcut:BV425_streamingcapcut:BV145_streamingcapcut:BV430_streamingcapcut:BV021_streamingcapcut:BV213_streamingcapcut:BV144_streamingcapcut:BV433_streamingcapcut:BV409_streamingcapcut:BV063_streamingcapcut:BV050_streamingcapcut:BV064_streamingcapcut:BV567_streamingcapcut:BV568_streamingcapcut:BV078_streamingcapcut:BV068_streamingcapcut:BV570_streaming Mặc định: | Giọng đọc AI |
textrequired | string | Tối đa 100.000 ký tự | Văn bản cần đọc — Hỗ trợ tới 100.000 ký tự (riêng nhóm giọng CapCut giới hạn 5.000 ký tự mỗi lượt). |
speed | number | 0.5 – 2 Mặc định: | Tốc độ đọc — 0.5 = chậm, 1.0 = tự nhiên, 2.0 = nhanh tối đa |
- Tham số file (string URL) nhận link công khai http(s) — máy chủ tự tải về — hoặc URL trả về từ API tải file POST /account/ai/uploads.
- Bỏ trống tham số không bắt buộc thì dùng giá trị mặc định.
Ví dụ request (cURL)
curl -X POST https://zova.io.vn/api/v1/generations \
-H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
-d '{
"model": "voice",
"voice": "Ngọc Huyền",
"text": "Một chú mèo phi hành gia",
"speed": 1
}'Code mẫu tích hợp đầy đủ (Upload file → Tạo tác vụ → Nhận kết quả)
Python 3
import os, time, requests
BASE = "https://zova.io.vn/api"
HEADERS = {"X-API-Key": os.environ["API_KEY"]}
gen = requests.post(f"{BASE}/v1/generations", headers=HEADERS, json={
"model": "voice",
"voice": "Ngọc Huyền",
"text": "Một chú mèo phi hành gia",
"speed": 1
}, timeout=60).json()
while gen.get("status") in ("queued", "processing"):
time.sleep(5)
gen = requests.get(f"{BASE}/v1/generations/{gen['id']}", headers=HEADERS, timeout=60).json()
if gen.get("status") != "succeeded":
raise RuntimeError(gen.get("error") or gen.get("status"))
print("Kết quả:", gen["output"])Node.js (18+)
const BASE = "https://zova.io.vn/api";
const headers = { "X-API-Key": process.env.API_KEY, "Content-Type": "application/json" };
let gen = await fetch(`${BASE}/v1/generations`, {
method: "POST",
headers,
body: JSON.stringify({
"model": "voice",
"voice": "Ngọc Huyền",
"text": "Một chú mèo phi hành gia",
"speed": 1
}),
}).then((r) => r.json());
while (["queued", "processing"].includes(gen.status)) {
await new Promise((r) => setTimeout(r, 5000));
gen = await fetch(`${BASE}/v1/generations/${gen.id}`, { headers }).then((r) => r.json());
}
if (gen.status !== "succeeded") throw new Error(gen.error ?? gen.status);
console.log("Kết quả:", gen.output);Output — kết quả trả về
Tác vụ chạy bất đồng bộ. POST /v1/generations trả ngay đối tượng generation với status queued hoặc processing; hỏi lại GET /v1/generations/{id} mỗi 5–10 giây tới khi status là succeeded, failed hoặc cancelled.
/v1/generations/{id}{
"id": "3f1c...-uuid",
"object": "generation",
"code": "T8KQ2M4X",
"model": "voice",
"status": "succeeded", // queued | processing | succeeded | failed | cancelled
"progress": 100,
"cost": 2400, // số tiền đã trừ
"currency": "VND",
"refunded": false,
"output": {
"type": "audio",
"files": [{ "url": "https://zova.io.vn/uploads/ai/outputs/....mp3", "type": "audio", "name": "audio.mp3" }],
"text": null
},
"error": null,
"created_at": "2026-10-30T08:00:00.000Z",
"completed_at": "2026-10-30T08:01:12.000Z"
}| Trường | Ý nghĩa |
|---|---|
| output.files[].url | Link file kết quả — nên tải về hệ thống của bạn, file trên máy chủ có thể được dọn sau một thời gian. |
| output.text | Nội dung văn bản (chỉ có với model trả văn bản). |
| cost | Số tiền VND đã trừ vào số dư; lỗi hoặc huỷ thì tự hoàn lại (refunded = true). |
| error | Lý do lỗi khi status = failed. |
Báo giá trước khi chạy
/v1/generations/estimateCùng body với POST /v1/generations, không chạy và không trừ tiền.
# => { "object": "estimate", "model": "voice", "cost": 2400, "currency": "VND" }