Âm nhạc
Lấy Trạng thái Nhạc
Lấy trạng thái và kết quả của một tác vụ tạo nhạc
Truy vấn (poll) endpoint này để kiểm tra trạng thái của tác vụ tạo nhạc của bạn.
Nếu phản hồi tạo bao gồm poll_url, hãy ưu tiên chính URL đó khi polling. id và task_id nên được coi là cùng một định danh của tác vụ bất đồng bộ.
Tác vụ công khai đã hết hạn hoặc không khả dụng có thể trả 404 async_task_not_found. Nếu không xác nhận được quyền sở hữu cho API key hiện tại, phản hồi là 403 task_not_owned.
Tham số Đường dẫn
ID của tác vụ tạo nhạc.
Phản hồi
ID của tác vụ.
Bí danh của cùng ID tác vụ bất đồng bộ, nếu được trả về.
URL polling ưu tiên khi phản hồi tạo tác vụ cung cấp.
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
Giá trị tiến độ tùy chọn. Chỉ được trả về khi có giá trị tiến độ thực; hãy dùng status để xác định khi tác vụ hoàn tất.
Trường kết quả phụ thuộc thao tác. Nhạc có thể trả về audio_url và audio_id; tác vụ chỉ tạo lời trả về lyrics; tách âm có thể trả nhiều tệp trong data. video_url, tiêu đề, tiến độ và siêu dữ liệu khác là tùy chọn. Dùng status để kiểm tra hoàn tất và đọc các trường thực sự được trả về.
ID âm thanh tùy chọn để dùng cùng ID tác vụ này trong các thao tác tiếp theo được hỗ trợ.
Mảng đầu ra tùy chọn, gồm các tệp âm thanh đã tách với audio_url hoặc url.
URL để tải xuống tệp âm thanh (khi hoàn tất).
URL dẫn đến phiên bản video với visualizer (khi hoàn tất).
Tiêu đề bài hát được tạo.
Lời bài hát được tạo hoặc được cung cấp.
Thông báo lỗi (khi thất bại).
Yêu cầu
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Phản hồi
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"audio_url": "https://cdn.example.com/music/abc123.mp3",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123"
}Xác thực
BearerAuth Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.
Vị trí: header
Tham số đường dẫn
ID tác vụ async được trả về bởi id / task_id, hoặc được nhúng trong poll_url
Phản hồi
application/json
application/json
application/json
application/json