Gửi yêu cầu tạo
Gửi payload tới endpoint của workflow. Có thể kèm receive_url nếu muốn nhận webhook.
API tạo nội dung · REST · tác vụ bất đồng bộ
Tích hợp giọng đọc, hội thoại, audio, nhạc Suno và tạo ảnh qua một base URL. API dùng cùng số dư credit cao cấp với ứng dụng web.
Mô hình tác vụ
Phần lớn API tạo nội dung chạy bất đồng bộ để xử lý được audio dài, nhạc và hình ảnh mà không giữ request mở.
Gửi payload tới endpoint của workflow. Có thể kèm receive_url nếu muốn nhận webhook.
Response tạo tác vụ trả về ID dùng chung để theo dõi trạng thái và lấy kết quả.
Gọi GET /v1/task/{task_id}, hoặc để OpenSpeaker gửi kết quả tới receive_url.
Endpoint tạo nội dung
Danh sách này chủ động loại Kokoro, Kiki, MiniMax Music cũ, Google Imagen cũ và Video/Veo vì chúng không nằm trong danh mục công khai đang hoạt động.
/v3/text-to-speech/v3/text-to-speech/dialogue/v3/dictionaries/v3/dictionaries/v3/dictionaries/preview/v3/text-to-speech/voice-clone/v1/task/dubbing/v1/task/voice-changer/v1/task/voice-isolate/v1/task/speech-to-text/v1/task/sound-effect/v1s/task/music-generation/v1i/models/v1i/task/price/v1i/task/generate-imageVí dụ an toàn
Thay $API_KEY và voice ID bằng dữ liệu tài khoản của bạn. Không đưa khóa thật vào source phía trình duyệt, repository công khai hoặc prompt gửi cho bên thứ ba.
curl -X POST "https://api.openspeaker.ai/v3/text-to-speech" \
-H "Content-Type: application/json" \
-H "xi-api-key: $API_KEY" \
-d '{
"text": "A long-form narration starts here.",
"voice_id": "provider:voice-id",
"speed": 1,
"receive_url": "https://example.com/webhooks/openspeaker"
}'Endpoint dùng chung
Dùng các endpoint này để vận hành tích hợp: theo dõi lịch sử, kiểm tra số dư, tìm giọng hoặc xóa tác vụ.
/v1/task/{task_id}Kiểm tra một tác vụ bất đồng bộ
/v1/tasksLiệt kê và lọc lịch sử tác vụ
/v1/task/deleteXóa tác vụ; hoàn credit khi workflow hỗ trợ
/v1/creditsĐọc số dư credit hiện tại
/v1/health-checkKiểm tra trạng thái API
/v3/voicesTìm trong thư viện giọng hợp nhất
Dùng bản text hoặc OpenAPI generation đã làm sạch để khám phá endpoint mà không cần crawl giao diện đã đăng nhập.