Nội dung yêu cầu
Timeout cho yêu cầu đồng bộ: endpoint không phải chat này chờ model được định tuyến hoàn tất. Input lớn, audio dài, hoặc batch lớn có thể vượt quá mặc định 30s phổ biến của client, vì vậy hãy đặt timeout của HTTP client ít nhất là120s.
Các field tuỳ chọn được hỗ trợ khác nhau theo từng họ model. TokenLab kiểm tra ma trận field này trước khi routing: OpenAI TTS nhận voice, instructions, response_format, stream_format, và speed; MiniMax speech nhận voice, voice_id, response_format, stream_format, và speed; Gemini TTS nhận prompt, language_code, voice, response_format, stream_format, speed, và temperature; các route TTS hẹp hơn kiểu Vidu/Kling có thể chỉ nhận input và stream_format. Field top-level không xác định, bao gồm user, sẽ trả về 400 unsupported_parameter thay vì bị bỏ qua.
Model TTS. Ví dụ gồm
tts-1, gpt-4o-mini-tts, speech-02-hd, và gemini-2.5-flash-tts. Gọi GET /v1/models?recommended_for=tts để lấy danh sách hiện tại.Văn bản dùng để tạo audio. Tối đa 4096 ký tự.
Bộ chọn giọng nói. Truyền tên giọng dựng sẵn như
nova, giọng Gemini như Kore, hoặc object như { "id": "voice-id" } cho giọng tuỳ chỉnh tương thích.Bộ chọn giọng native của provider cho các model speech tương thích MiniMax.
Chỉ dẫn style hoặc cách đọc tuỳ chọn cho các model TTS tương thích OpenAI có hỗ trợ.
Prompt style nói tuỳ chọn cho model Gemini TTS.
Mã ngôn ngữ tuỳ chọn, ví dụ
en-US, cho các route Gemini, xAI và TTS tương thích.Định dạng audio. Giá trị phổ biến gồm
mp3, opus, aac, flac, wav, và pcm; giá trị được hỗ trợ khác nhau theo họ model.Định dạng trả về của TokenLab:
audio hoặc sse. stream_format=sse không được hỗ trợ cho tts-1 hoặc tts-1-hd.Tốc độ nói cho các họ model có hỗ trợ (0.25 đến 4.0).
Sampling temperature cho các route TTS tương thích Gemini (0 đến 2).
Phản hồi
Trả về tệp audio theo định dạng đã yêu cầu.Mẫu giọng nói
| Voice | Mô tả |
|---|---|
alloy | Trung tính, cân bằng |
ash | Điềm tĩnh, chuẩn mực |
ballad | Du dương, giàu biểu cảm |
coral | Ấm áp, cuốn hút |
echo | Ấm áp, mang tính hội thoại |
fable | Giàu biểu cảm, phù hợp kể chuyện |
nova | Thân thiện, rõ ràng |
onyx | Trầm, uy quyền |
sage | Uyên bác, sâu sắc |
shimmer | Mềm mại, dịu dàng |
verse | Năng động, linh hoạt |
Ví dụ phản hồi
Trường quan trọng
Loại event hoặc message do API trả về.
Nội dung phản hồi thô. Lưu trực tiếp, không parse như JSON.