Chuyển đến nội dung chính
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ộ.If the task no longer exists or can no longer be resolved through the public async-task contract, LemonData returns async_task_not_found with the message 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.lemondata.cc/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..."
}