Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

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ộ.Nếu tác vụ không còn tồn tại hoặc không còn có thể được phân giải thông qua hợp đồng tác vụ bất đồng bộ công khai, TokenLab trả về async_task_not_found với thông điệp Task not found or no longer available.

​
Tham số Đường dẫn

​
id
string
bắt buộc
ID của tác vụ tạo nhạc.

​
Phản hồi

​
id
string
ID của tác vụ.
​
task_id
string
Bí danh của mã tác vụ bất đồng bộ khi có sẵn.
​
status
string
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
​
progress
integer
Phần trăm tiến độ (0-100).
​
audio_url
string
URL để tải xuống tệp âm thanh (khi hoàn tất).
​
video_url
string
URL dẫn đến phiên bản video với visualizer (khi hoàn tất).
​
title
string
Tiêu đề bài hát được tạo.
​
lyrics
string
Lời bài hát được tạo hoặc được cung cấp.
​
error
string
Thông báo lỗi (khi thất bại).
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "completed",
  "audio_url": "https://cdn.suno.ai/abc123.mp3",
  "video_url": "https://cdn.suno.ai/abc123.mp4",
  "title": "Night Drive",
  "lyrics": "[Verse 1]\nDriving through the night..."
}