Kling 작업 조회

GET

kling

{action}

{action2}

{task_id}

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
}

Kling 작업을 생성한 후 이 엔드포인트 그룹을 사용하세요. Kling 비동기 미디어 작업에 공통으로 적용되는 폴링 단계입니다.

쿼리는 작업 객체를 직접 반환하거나 표준 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를 사용할 때는 래퍼를 확인하세요.

폴링 패턴

해당 엔드포인트에서 작업 생성

워크플로에 맞는 Kling 생성 페이지에서 시작하세요. 예를 들어 텍스트-비디오, 이미지-비디오또는 Motion Control.

작업이 종료 상태에 도달할 때까지 폴링

응답 형태를 정규화한 다음, 반환된 작업 ID로 계속 조회하세요 종료 상태에 도달할 때까지. Motion Control의 종료 상태는 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}`

전체 매개변수 참조는 공식 Kling 문서를 참조하세요..

인증

Authorization

string

header

필수

Bearer token authentication. Use your CometAPI key.

경로 매개변수

action

string

필수

Resource type. One of: images, videos, audio.

action2

string

필수

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

string

필수

Task ID

응답

200 - application/json

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.

task_id

string

필수

Kling task ID.

task_status

string

필수

Current task state. Compatible Motion Control tasks use submitted, processing, succeed, or failed.

task_status_msg

string

Failure or status detail when returned.

task_info

object

Additional task metadata. The object can be empty.

task_result

object

Absent on an initial submitted task, commonly empty while processing or after failure, and populated when a task succeeds.

Show child attributes

watermark_info

object

Watermark information when returned by a compatible workflow.

Show child attributes

created_at

integer<int64>

Task creation timestamp in milliseconds.

updated_at

integer<int64>

Last task update timestamp in milliseconds.

final_unit_deduction

string

Final unit deduction value, when returned.

final_balance_deduction

object

Final balance deduction values, when returned.

Show child attributes

마지막 수정일 2026년 7월 31일

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
}

콘텐츠 검토

API 키

먼저 확인할 사항

폴링 패턴

일반적인 경로 쌍

인증

경로 매개변수

응답

​먼저 확인할 사항

​폴링 패턴

​일반적인 경로 쌍

인증

경로 매개변수

응답

먼저 확인할 사항

폴링 패턴

일반적인 경로 쌍