TokenLab

음악

음악 상태 가져오기

음악 생성 작업의 상태 및 결과를 가져옵니다

GET
/v1/tasks/{id}

GET /v1/music/generations/{id}는 호환성 엔드포인트입니다. 기존 통합을 위해 계속 지원됩니다. 새로운 통합은 GET /v1/tasks/{id}를 폴링해야 합니다. 작업 상태 가져오기를 참조하세요.

GET /v1/tasks/{id}를 호출하여 음악 생성 작업의 상태를 확인하세요.

id와 task_id는 동일한 작업을 식별합니다.

만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키에 대한 작업 소유권을 확인할 수 없는 경우, 응답은 403 task_not_owned가 됩니다.

경로 매개변수 (Path Parameters)

idstringpath필수

음악 생성 작업 ID입니다.

응답 (Response)

idstring

작업 ID입니다.

task_idstring

반환 시 동일한 비동기 작업 ID의 별칭입니다.

poll_urlstring

이 작업에 대한 상태 URL입니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하세요.

statusstring

작업 상태: pending, processing, completed, failed 또는 timeout. 실패한 작업도 HTTP 200을 반환합니다.

progressinteger

선택적 진행률 값입니다. 실제 진행률 값을 사용할 수 있을 때만 반환되며, 완료 여부를 확인하려면 status를 사용하세요.

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

audio_idstring

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

dataarray

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

audio_urlstring

오디오 파일을 다운로드할 수 있는 URL입니다(완료 시). 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.

video_urlstring

비주얼라이저가 포함된 비디오 버전의 URL입니다(완료되어 모델에서 반환되는 경우).

image_urlstring

모델이 커버 이미지를 반환할 때의 이미지 URL입니다.

titlestring

생성된 곡 제목입니다.

lyricsstring

생성되었거나 제공된 가사입니다.

errorstring | object

오류 메시지입니다(실패 시).

error_detailsobject

작업 실패 시의 상세 정보입니다: status, message, type, code, retryable, 그리고 요청 필드에 문제가 있을 경우 param이 포함됩니다.

media_retentionobject

결과 링크의 저장 상태입니다: days 및 url, kind, status, expires_at을 포함하는 items[]. 이 필드는 없을 수도 있으며, 링크는 여전히 작동합니다. 데이터 보존을 참조하세요.

요청

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://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"
      }
    ]
  }
}

인증

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

application/json

application/json

application/json