비디오 및 자료
비디오 상태 가져오기
비디오 작업의 상태 및 결과를 가져옵니다.
경로 매개변수 (Path Parameters)
비디오 생성 요청 시 반환된 작업 ID입니다. id와 task_id는 동일한 작업을 식별합니다.
생성 응답에 poll_url이 포함되어 있다면 해당 URL을 직접 호출하십시오.
만료되었거나 사용할 수 없는 공개 작업은 404 async_task_not_found를 반환할 수 있습니다. 현재 API 키로 작업 소유권을 확인할 수 없는 경우, 응답은 403 task_not_owned가 됩니다.
응답 (Response)
결과, 오류, 타임스탬프 및 모델을 설명하는 필드는 작업에 대해 사용 가능한 경우 반환됩니다.
작업 ID입니다.
id와 동일한 작업 ID입니다.
상태 확인 및 결과 검색을 위한 URL입니다.
결제 완료 후의 청구 트랜잭션 ID입니다. 작업 ID와는 별개입니다.
작업 상태: pending, processing, completed, failed.
선택적 진행률 값입니다. 실제 진행률 값을 사용할 수 있는 경우에만 반환됩니다. 완료 여부를 확인하려면 status를 사용하십시오.
생성된 비디오의 URL입니다(완료 시). TokenLab API를 가리키는 경우, 작업 폴링에 사용된 것과 동일한 Authorization: Bearer 헤더를 사용하여 다운로드하십시오. 작업을 소유한 조직만 결과에 액세스할 수 있습니다.
사용 가능한 경우 url, duration, width, height를 포함하는 단일 비디오 결과입니다.
작업이 하나 이상의 출력을 반환할 때의 다중 비디오 결과입니다.
오류 메시지입니다(실패 시).
생성 타임스탬프입니다.
마지막 업데이트 타임스탬프입니다.
작업에 사용된 모델입니다.
요청
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
}확인 간격 (Check Interval)
- 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", "Video generation failed"))
time.sleep(interval)
raise TimeoutError("Video generation timed out")인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.
응답
application/json
application/json
application/json
application/json