음악
음악 상태 가져오기
음악 생성 작업의 상태 및 결과를 가져옵니다
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)
음악 생성 작업 ID입니다.
응답 (Response)
작업 ID입니다.
반환 시 동일한 비동기 작업 ID의 별칭입니다.
이 작업에 대한 상태 URL입니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하세요.
작업 상태: pending, processing, completed, failed 또는 timeout. 실패한 작업도 HTTP 200을 반환합니다.
선택적 진행률 값입니다. 실제 진행률 값을 사용할 수 있을 때만 반환되며, 완료 여부를 확인하려면 status를 사용하세요.
결과 필드는 작업에 따라 다릅니다. 음악은 audio_url 및 audio_id를 반환할 수 있으며, 가사 전용 작업은 lyrics를 반환합니다. 분리(separation) 작업은 data에 여러 파일을 반환할 수 있습니다. video_url, 제목, 진행률 및 기타 메타데이터는 선택 사항입니다. 완료 여부는 status를 확인하고 실제로 반환된 필드를 읽으세요.
선택적 소스 오디오 ID로, 지원되는 후속 작업에서 이 작업의 ID와 함께 사용할 수 있습니다.
audio_url 또는 url이 포함된 분리된 오디오 파일을 포함하는 선택적 출력 배열입니다.
오디오 파일을 다운로드할 수 있는 URL입니다(완료 시). 30일 동안 유효한 TokenLab 미디어 결과 링크입니다.
비주얼라이저가 포함된 비디오 버전의 URL입니다(완료되어 모델에서 반환되는 경우).
모델이 커버 이미지를 반환할 때의 이미지 URL입니다.
생성된 곡 제목입니다.
생성되었거나 제공된 가사입니다.
오류 메시지입니다(실패 시).
작업 실패 시의 상세 정보입니다: status, message, type, code, retryable, 그리고 요청 필드에 문제가 있을 경우 param이 포함됩니다.
결과 링크의 저장 상태입니다: 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 API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.
응답
application/json
application/json
application/json
application/json
application/json
application/json
application/json