TokenLab
API 키 받기
문서API 레퍼런스통합

음악

음악 생성 상태 조회

음악 생성 작업의 상태와 결과를 조회합니다.

GET
/v1/tasks/{id}

이 엔드포인트를 폴링하여 음악 생성 작업의 상태를 확인하세요.

생성 응답에 poll_url 이 포함되어 있으면, 상태 조회에는 그 URL 을 우선 사용하세요. id 와 task_id 는 같은 비동기 작업 ID 로 취급해야 합니다.

만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키로 작업 소유권을 확인할 수 없으면 403 task_not_owned가 반환됩니다.

경로 파라미터

idstringpath필수

음악 생성 작업 ID입니다.

응답

idstring

작업 ID.

task_idstring

동일한 비동기 작업 ID의 별칭이며 반환되는 경우에만 존재합니다.

poll_urlstring

생성 응답에서 제공될 때 우선 사용할 폴링 URL입니다.

statusstring

작업 상태: pending, processing, completed 또는 failed.

progressinteger

선택적 진행 값입니다. 실제 진행 값이 제공될 때만 반환됩니다. 완료 여부는 status 로 판단하세요.

결과 필드는 작업에 따라 다릅니다. 음악은 audio_url과 audio_id, 가사 전용 작업은 lyrics, 음원 분리는 data에 여러 파일을 반환할 수 있습니다. video_url, 제목, 진행률 등은 선택 사항입니다. status로 완료 여부를 확인하고 실제 반환된 필드를 읽으세요.

audio_idstring

지원되는 후속 작업에서 이 작업 ID와 함께 사용할 수 있는 선택적 오디오 ID입니다.

dataarray

선택적 출력 배열입니다. 분리된 오디오 파일의 audio_url 또는 url을 포함합니다.

audio_urlstring

오디오 파일을 다운로드할 URL (완료 시).

video_urlstring

비주얼라이저가 포함된 비디오 버전의 URL (완료 시).

titlestring

생성된 곡 제목.

lyricsstring

생성되거나 제공된 가사.

errorstring | object

에러 메시지 (실패 시).

요청

curl --fail-with-body "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.example.com/music/abc123.mp3",
  "title": "Night Drive",
  "lyrics": "[Verse 1]\nDriving through the night...",
  "audio_id": "audio_abc123"
}

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

경로 매개변수

id*string

id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.

응답

application/json

application/json

application/json

application/json

음악 생성

이전

비디오 생성

다음