Skip to main content

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 inputstream_format. Field top-level không xác định, bao gồm user, sẽ trả về 400 unsupported_parameter thay vì bị bỏ qua.
string
mặc định:"tts-1"
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.
string
bắt buộc
Văn bản dùng để tạo audio. Tối đa 4096 ký tự.
string | object
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.
string
Bộ chọn giọng native của provider cho các model speech tương thích MiniMax.
string
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ợ.
string
Prompt style nói tuỳ chọn cho model Gemini TTS.
string
Mã ngôn ngữ tuỳ chọn, ví dụ en-US, cho các route Gemini, xAI và TTS tương thích.
string
Đị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.
string
mặc định:"audio"
Đị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.
number
Tốc độ nói cho các họ model có hỗ trợ (0.25 đến 4.0).
number
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

Ví dụ phản hồi

Trường quan trọng

string
Loại event hoặc message do API trả về.
binary
Nội dung phản hồi thô. Lưu trực tiếp, không parse như JSON.