API tạo nội dung · REST · tác vụ bất đồng bộ

Xây dựng với OpenSpeaker.
Một API cho nhiều workflow AI.

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ụ

Tạo một lần. Nhận task ID. Theo dõi hoặc chờ webhook.

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ở.

01

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.

02

Nhận task_id

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ả.

03

Polling hoặc webhook

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

Các workflow production đã đối chiếu.

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.

Công cụPhương thứcPath
Chuyển văn bản thành giọng nóiPOST/v3/text-to-speech
Tạo hội thoại từ văn bảnPOST/v3/text-to-speech/dialogue
Từ điển phát âmGET/v3/dictionaries
Từ điển phát âmPOST/v3/dictionaries
Từ điển phát âmPOST/v3/dictionaries/preview
Nhân bản giọng nóiPOST/v3/text-to-speech/voice-clone
Lồng tiếng tệp âm thanh bằng AIPOST/v1/task/dubbing
Đổi giọngPOST/v1/task/voice-changer
Tách giọngPOST/v1/task/voice-isolate
Chuyển giọng nói thành văn bảnPOST/v1/task/speech-to-text
Tạo hiệu ứng âm thanhPOST/v1/task/sound-effect
Tạo nhạc bằng AIPOST/v1s/task/music-generation
Tạo ảnh bằng AIGET/v1i/models
Tạo ảnh bằng AIPOST/v1i/task/price
Tạo ảnh bằng AIPOST/v1i/task/generate-image

Ví dụ an toàn

Tạo giọng đọc bằng curl.

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.

  • Text tối đa 1.000.000 ký tự mỗi tác vụ
  • Speed từ 0,5 đến 1,5
  • Có transcript, từ điển phát âm và webhook
curl
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

Task, credit, voice và trạng thái.

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ụ.

GET/v1/task/{task_id}

Kiểm tra một tác vụ bất đồng bộ

GET/v1/tasks

Liệt kê và lọc lịch sử tác vụ

POST/v1/task/delete

Xóa tác vụ; hoàn credit khi workflow hỗ trợ

GET/v1/credits

Đọc số dư credit hiện tại

GET/v1/health-check

Kiểm tra trạng thái API

GET/v3/voices

Tìm trong thư viện giọng hợp nhất

Dành cho AI agent và công cụ sinh code

Dữ liệu API cũng có bản máy đọc.

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.

/api-guide.txt/openapi-generation.json