동영상 조회
Kling 4.0 네이티브 텍스트·이미지·Omni 작업의 상태와 결과를 조회합니다.
생성 응답의 data.id로 조회합니다. 성공하면 outputs에서 영상 URL을 읽고 저장하세요. 현재 사용자가 접근할 수 있는 작업만 반환됩니다.
/kling/tasks/{task_id}현재 사용자의 단일 Kling 4.0 텍스트·이미지·Omni 작업을 조회합니다. options.external_task_id가 아닌 시스템 작업 ID를 사용합니다. 상태는 submitted, processing, succeeded, failed입니다. 폴링 중단은 취소가 아닙니다. billing은 작업 정가·통화만 공개하며 계정 청구·내부 차감 내역은 포함하지 않습니다.
billing.list_price는 해당 통화의 정가이며 플랫폼 최종 청구액이 아닙니다. 가격은 영상보다 늦게 표시될 수 있으며 가격 누락이 무료를 뜻하지 않습니다.
상태와 결과 저장
조회 응답의 data는 단일 ID 조회에서도 작업 배열입니다. 요청의 code와 생성 작업의 status는 다릅니다. 결과 사용 전에 작업 상태를 확인하세요.
status | 의미 |
|---|---|
submitted | 제출 완료, 처리 대기 |
processing | 처리 중, 나중에 조회 |
succeeded | 생성 성공, outputs에서 결과 읽기 |
failed | 생성 실패, message 확인 후 폴링 중단 |
영상 결과의 type는 video이며 id는 영상 ID, duration는 문자열로 반환되는 초 단위 길이입니다. url는 핫링크 보호 URL입니다. 워터마크 결과는 반환된 watermark_url를 확인하세요.
상위 서비스의 결과는 30일 후 삭제됩니다. 즉시 저장하세요. 이 보관 규칙이 URL의 30일 유효성을 보장하지는 않습니다.
조회 오류와 작업 실패
| 상황 | 확인 및 조치 |
|---|---|
HTTP 400, task_not_exist | 생성 응답의 시스템 작업 ID 사용, API Key·사이트 확인, options.external_task_id 사용 금지 |
HTTP 401, Invalid token | Bearer 형식과 Key 유효성 확인. 누락·무효 Key는 같은 오류일 수 있음 |
HTTP 200, 작업 status: "failed" | 조회 성공, 생성 실패. 작업의 message를 읽고 폴링 중단 |
HTTP 오류 구조는 성공 응답의 data[]와 다를 수 있습니다. HTTP 400/401을 작업의 failed로 해석하지 말고 인증 오류·작업 없음에서는 폴링을 중단하세요.