Âm nhạc
Lấy trạng thái âm nhạc
Truy xuất trạng thái và kết quả của một tác vụ tạo âm nhạc
GET /v1/music/generations/{id} là một endpoint tương thích. Nó vẫn được hỗ trợ cho các tích hợp hiện có. Các tích hợp mới nên thực hiện poll GET /v1/tasks/{id}; xem Lấy trạng thái tác vụ.
Gọi GET /v1/tasks/{id} để kiểm tra trạng thái tác vụ tạo âm nhạc của bạn.
id và task_id xác định cùng một tác vụ.
Một tác vụ công khai đã hết hạn hoặc không khả dụng có thể trả về 404 async_task_not_found. Nếu không thể xác định quyền sở hữu tác vụ cho API key hiện tại, phản hồi sẽ là 403 task_not_owned.
Tham số đường dẫn (Path Parameters)
ID của tác vụ tạo âm nhạc.
Phản hồi (Response)
ID của tác vụ.
Bí danh của cùng một ID tác vụ bất đồng bộ, khi được trả về.
URL trạng thái cho tác vụ này. Hãy poll GET /v1/tasks/{id} với id.
Trạng thái tác vụ: pending, processing, completed, failed, hoặc timeout. Một tác vụ thất bại vẫn trả về HTTP 200.
Giá trị tiến trình tùy chọn. Chỉ được trả về khi có giá trị tiến trình thực tế; hãy sử dụng status để xác định việc hoàn thành.
Các trường kết quả phụ thuộc vào thao tác. Âm nhạc có thể trả về audio_url và audio_id; các tác vụ chỉ có lời bài hát trả về lyrics; tách âm thanh có thể trả về nhiều tệp trong data. video_url, tiêu đề, tiến trình và các siêu dữ liệu khác là tùy chọn. Hãy kiểm tra status để biết trạng thái hoàn thành và đọc các trường thực tế được trả về.
ID âm thanh nguồn tùy chọn, có thể sử dụng cùng với ID của 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, bao 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). Một liên kết kết quả phương tiện của TokenLab có hiệu lực trong 30 ngày.
URL đến phiên bản video có trình hiển thị hình ảnh (khi hoàn tất và được trả về cho mô hình).
URL ảnh bìa, khi mô hình trả về một ảnh.
Tiêu đề bài hát đã tạo.
Lời bài hát đã tạo hoặc được cung cấp.
Thông báo lỗi (khi thất bại).
Chi tiết lỗi khi tác vụ thất bại: status, message, type, code, retryable, và param khi một trường yêu cầu bị lỗi.
Trạng thái lưu trữ của các liên kết kết quả: days và items[] với url, kind, status, và expires_at. Nó có thể không xuất hiện; các liên kết vẫn hoạt động. Xem Lưu trữ dữ liệu.
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://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"kind": "audio",
"content_type": "audio/mpeg",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}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
application/json
application/json
application/json