메인 콘텐츠로 건너뛰기

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.

이 엔드포인트를 폴링하여 음악 생성 작업의 상태를 확인하세요.
생성 응답에 poll_url 이 포함되어 있으면, 상태 조회에는 그 URL 을 우선 사용하세요. id 와 task_id 는 같은 비동기 작업 ID 로 취급해야 합니다.작업이 더 이상 존재하지 않거나 공개 async-task 계약을 통해 더 이상 해결할 수 없으면, TokenLab는 메시지 async_task_not_found와 함께 Task not found or no longer available.를 반환합니다.

​
경로 파라미터

​
id
string
필수
음악 생성 작업 ID입니다.

​
응답

​
id
string
작업 ID.
​
task_id
string
사용 가능할 때의 비동기 작업 ID 별칭입니다.
​
status
string
작업 상태: pending, processing, completed 또는 failed.
​
progress
integer
진행률 백분율 (0-100).
​
audio_url
string
오디오 파일을 다운로드할 URL (완료 시).
​
video_url
string
비주얼라이저가 포함된 비디오 버전의 URL (완료 시).
​
title
string
생성된 곡 제목.
​
lyrics
string
생성되거나 제공된 가사.
​
error
string
에러 메시지 (실패 시).
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..."
}