비디오 및 자료
비디오 상태 가져오기
비디오 작업의 상태 및 결과를 가져옵니다
GET /v1/videos/generations/{id}는 호환성 엔드포인트입니다. 기존 통합을 위해 계속 지원되며 GET /v1/tasks/{id}와 동일한 형식으로 결과를 반환합니다. 새로운 통합은 GET /v1/tasks/{id}를 폴링해야 합니다. 작업 상태 가져오기를 참조하세요.
경로 매개변수
비디오 생성 요청 시 반환된 작업 ID입니다. id와 task_id는 동일한 작업을 식별합니다.
작업이 실패한 경우에도 상태 조회는 HTTP 200을 반환하므로 status를 확인해야 합니다. 만료되었거나 사용할 수 없는 작업은 404 async_task_not_found를 반환합니다. 워크스페이스에 속하지 않은 작업은 403 task_not_owned를 반환합니다. 503 async_task_owner_unavailable는 일시적인 오류이므로 요청을 재시도하세요.
응답
결과, 오류, 타임스탬프 및 모델을 설명하는 필드는 작업에 대해 사용 가능한 경우 반환됩니다.
작업 ID입니다.
id와 동일한 작업 ID입니다.
이 작업에 대한 상태 URL입니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하세요.
결제 완료 후의 청구 트랜잭션 ID입니다. 작업 ID와는 별개입니다.
작업 상태: pending, processing, completed, failed.
0에서 100 사이의 선택적 진행률입니다. 실제 진행률 값을 사용할 수 있는 경우에만 반환됩니다. 완료 여부를 확인하려면 status를 사용하세요.
생성된 비디오의 URL입니다(완료 시). 이는 30일 동안 유효한 TokenLab 미디어 결과 URL입니다. 결과 다운로드를 참조하세요. 실패했거나 완료되지 않은 작업은 비디오 URL을 반환하지 않습니다.
return_last_frame으로 요청했고 모델이 이를 지원하는 경우, 마지막으로 생성된 프레임의 URL입니다.
사용 가능한 경우 url, duration, width, height를 포함하는 단일 비디오 결과입니다.
작업이 하나 이상의 출력을 반환할 때의 다중 비디오 결과입니다.
작업이 실패한 이유(status가 failed인 경우에만): 문자열이거나, message를 포함하는 객체이며, 알려진 경우 type, code, param, retryable을 포함합니다. 실패한 작업은 error_details를 포함할 수도 있습니다. 비동기 작업 및 폴링을 참조하세요.
비디오 저장 상태: days 및 items를 포함하며, 각 항목은 url, kind, status, expires_at을 가집니다. 상태를 제때 알 수 없는 경우 누락될 수 있으나, URL은 여전히 작동합니다.
생성 타임스탬프입니다.
마지막 업데이트 타임스탬프입니다.
작업에 사용된 모델입니다.
요청
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": "pending",
"model": "veo3.1",
"created": 1706000000,
"updated": 1706000000
}결과 다운로드
video_url은 https://api.tokenlab.sh/v1/media-results/{id}.mp4?token=…와 같은 형태입니다. URL 내의 토큰이 자격 증명이므로 Authorization 헤더는 필요하지 않습니다. 비디오를 볼 수 있는 사람에게만 URL을 공유하세요. URL은 파일로 리디렉션되므로 다운로드 시 리디렉션을 따라가야 합니다(curl -L).
- 결과가 처음 기록된 시점부터 30일 동안 유효합니다. 더 오래 보관해야 하는 경우 파일을 다운로드하세요. 데이터 보존을 참조하세요.
404 media_not_found: 토큰이나 파일 확장자가 결과와 일치하지 않습니다. 받은 정확한 URL을 사용하세요.410 media_expired: 30일 기간이 종료되었습니다.502또는503 media_unavailable: 결과가 아직 기록 중이거나 TokenLab이 바쁜 상태입니다.Retry-After지연 시간 이후에 재시도하세요.- 파일 대신 저장 상태를 읽으려면 URL에
metadata=true를 추가하세요.
일부 결과는 https://api.tokenlab.sh/v1/videos/generations/{id}/content로 전달됩니다. 해당 URL은 폴링에 사용하는 것과 동일한 Authorization: Bearer 헤더가 필요하며, 작업을 소유한 워크스페이스만 열 수 있습니다.
확인 간격
- 5~10초마다 확인하세요.
- 오래 걸리는 작업의 경우 간격을 늘리세요.
- 애플리케이션에 최대 대기 시간을 설정하세요.
- 상태가
failed이면 중단하고 반환된error를 표시하세요.
import requests
import time
def wait_for_video(task_id, max_wait=600, interval=5):
"""타임아웃을 포함한 비디오 대기 함수."""
start = time.time()
while time.time() - start < max_wait:
response = requests.get(
f"https://api.tokenlab.sh/v1/tasks/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"}
)
response.raise_for_status()
data = response.json()
if data["status"] == "completed":
return data["video_url"]
elif data["status"] == "failed":
raise Exception(data.get("error", "비디오 생성 실패"))
time.sleep(interval)
raise TimeoutError("비디오 생성 시간 초과")인증
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