Kling 작업 조회
task_id로 Kling 비디오 생성 작업을 조회하고, 폴링을 위한 상태, 진행률 및 결과 메타데이터를 반환합니다.
curl "https://api.cometapi.com/kling/v1/videos/text2video/<task_id>" \
-H "Authorization: Bearer $COMETAPI_KEY"{
"task_id": "<task_id>",
"task_status": "submitted",
"task_info": {},
"created_at": 1781080355827,
"updated_at": 1781080355827
}data
래퍼 내부에 반환할 수 있습니다. 작업 필드를 읽기 전에 각 응답을 task = payload.data ?? payload로
정규화하세요.먼저 확인할 사항
task.task_status; Motion Control 작업에서는submitted,processing,succeed또는failed를task.task_result.videos[0].url비디오 작업이 성공했을 때 사용하고,task.task_status_msg또는 작업이 조기에 중단되었을 때 반환된 기타 세부 필드를 사용하며code,message, 그리고 응답이 표준request_id를 사용할 때는 래퍼를 확인하세요.
폴링 패턴
해당 엔드포인트에서 작업 생성
작업이 종료 상태에 도달할 때까지 폴링
succeed 및 failed입니다.다음 워크플로 단계로 계속
일반적인 경로 쌍
| 워크플로 | 조회 경로 |
|---|---|
| 텍스트-비디오 | /kling/v1/videos/text2video/{task_id} |
| 이미지-비디오 | /kling/v1/videos/image2video/{task_id} |
| Motion Control | /kling/v1/videos/motion-control/{task_id} |
| 다중 이미지 비디오 | /kling/v1/videos/multi-image2video/{task_id} |
| 비디오 효과 | /kling/v1/videos/effects/{task_id} |
| 비디오 확장 | /kling/v1/videos/video-extend/{task_id} |
| 아바타 비디오 | /kling/v1/videos/avatar/image2video/{task_id} |
인증
Bearer token authentication. Use your CometAPI key.
경로 매개변수
Resource type. One of: images, videos, audio.
Sub-action matching the resource type. For images: generations, kolors-virtual-try-on. For videos: text2video, image2video, motion-control, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.
Task ID
응답
Current Kling task state.
- Option 1
- Option 2
A query can return the task object directly or inside the standard response envelope. Normalize both shapes before reading task fields.
Kling task ID.
Current task state. Compatible Motion Control tasks use submitted, processing, succeed, or failed.
Optional compatibility response status. For a direct legacy Kling task response, synthesized values are PENDING, RUNNING, SUCCEEDED, or FAILED; use task_status as the canonical task state.
Failure or status detail when returned.
Additional task metadata. The object can be empty.
Absent on an initial submitted task, commonly empty while processing or after failure, and populated when a task succeeds.
Show child attributes
Show child attributes
Watermark information when returned by a compatible workflow.
Show child attributes
Show child attributes
Task creation timestamp in milliseconds.
Last task update timestamp in milliseconds.
Final unit deduction value, when returned.
Final balance deduction values, when returned.
Show child attributes
Show child attributes
curl "https://api.cometapi.com/kling/v1/videos/text2video/<task_id>" \
-H "Authorization: Bearer $COMETAPI_KEY"{
"task_id": "<task_id>",
"task_status": "submitted",
"task_info": {},
"created_at": 1781080355827,
"updated_at": 1781080355827
}