Chuyển văn bản thành giọng nói

Nhận một đoạn văn bản và trả về đường dẫn tới file audio đọc nội dung đó. Với văn bản ngắn, thời gian phản hồi thường dưới 200ms.

x-api-keystring

Truyền API key qua header x-api-key: x-api-key: YOUR_API_KEY

Idempotency-KeystringOptionalformat: "uuid"

Khóa duy nhất (khuyến nghị dùng UUID) giúp tránh xử lý trùng lặp khi client retry cùng một request.

This endpoint expects an object.

textstringRequired

Văn bản cần chuyển thành giọng nói.

voicestringOptional

Mã giọng đọc sử dụng. Bỏ trống sẽ dùng giọng mặc định.

speedfloatOptionalDefaults to 1

Tốc độ đọc, 1.0 là tốc độ chuẩn.

formatenumOptionalDefaults to mp3

Định dạng file audio trả về.

Thành công.

audio_urlstringformat: "uri"

Đường dẫn tải file audio đã tạo.

formatstring

duration_msinteger

Độ dài file audio (mili giây).

charactersinteger

Số ký tự thực tế của văn bản đầu vào.

credits_usedinteger

Số credit đã bị trừ cho request này.

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

429

Too Many Requests Error

$	curl -X POST https://api.omicx.one/public-svc/api/ai/tts \
>	-H "Idempotency-Key: 6f9619ff-8b86-d011-b42d-00c04fc964ff" \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"text": "Xin chào, đây là bản demo từ OMICX"
>	}'

1	{
2	"audio_url": "https://cdn.omicx.one/tts/output/6f9619ff-8b86-d011-b42d-00c04fc964ff.mp3",
3	"format": "mp3",
4	"duration_ms": 1850,
5	"characters": 20,
6	"credits_used": 2
7	}