메인 콘텐츠로 건너뛰기
GET
/
kling
/
v1
/
{action}
/
{action2}
/
{task_id}
Individual queries
curl --request GET \
  --url https://api.cometapi.com/kling/v1/{action}/{action2}/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_info": {
      "parent_video": {
        "id": "<string>",
        "url": "<string>",
        "duration": "<string>"
      }
    },
    "task_result": {
      "videos": [
        {
          "id": "<string>",
          "url": "<string>",
          "duration": "<string>"
        }
      ]
    },
    "created_at": 123,
    "updated_at": 123
  }
}
Kling 작업을 생성한 후에는 이 엔드포인트 계열을 사용하세요. Kling 비동기 미디어 작업에서 공통으로 사용하는 폴링 단계입니다.

먼저 확인할 사항

  • 래퍼가 반환한 작업 상태 또는 작업 진행률 필드
  • 작업이 완료되었을 때의 출력 메타데이터 또는 에셋 URL
  • 작업이 조기에 중단되었을 때의 provider별 실패 메시지

폴링 패턴

1

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

Text to Video 또는 Image to Video처럼 워크플로에 맞는 Kling 생성 페이지에서 시작하세요.
2

작업이 종료 상태가 될 때까지 폴링

반환된 task id를 사용해 status가 success 또는 failure에 도달할 때까지 계속 조회하세요.
3

다음 워크플로 단계로 진행

완료된 출력을 바로 사용하거나, 워크플로가 연계 작업을 지원하는 경우 다음 provider별 작업 페이지로 이동하세요.
전체 파라미터 참조는 공식 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, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.

task_id
string
필수

Task ID

응답

200 - application/json

Successful Response

code
integer
필수

Return code

message
string
필수

Text description of the request result

request_id
string
필수

Unique identifier for this request

data
object
필수

Object containing specific response data