콜백 프로토콜

기타 매개변수

공식 문서 https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice 를 참고하세요. 매개변수는 동일하며, 연동 시 요청 도메인과 API 키만 당사 것으로 변경하면 됩니다.

비동기 작업 콜백 프로토콜

비동기 작업(이미지 생성/동영상 생성)에서 작업 생성 시 callback_url 을 설정하면, 작업 상태가 변경될 때 서버가 능동적으로 알림을 보냅니다.

콜백 데이터 형식

{
  "task_id": "string",           // 任务ID，系统生成
  "task_status": "string",       // 任务状态
  "task_status_msg": "string",   // 任务状态信息
  "created_at": 1722769557708,   // 任务创建时间（Unix时间戳，单位ms）
  "updated_at": 1722769557708,   // 任务更新时间（Unix时间戳，单位ms）
  "task_result": {
    "images": [                  // 图片类任务的结果
      {
        "index": 0,             // 图片编号，0-9
        "url": "string"         // 生成图片的URL
      }
    ],
    "videos": [                 // 视频类任务的结果
      {
        "id": "string",         // 视频ID，全局唯一
        "url": "string",        // 视频的URL
        "duration": "string"    // 视频总时长，单位s
      }
    ]
  }
}

작업 상태 설명

task_status 가능한 값:

• submitted: 제출됨
• processing: 처리 중
• succeed: 성공
• failed: 실패

주의사항

• 작업이 실패하면 task_status_msg 에 실패 사유가 표시됩니다(예: 플랫폼 콘텐츠 검수 등)
• 이미지 URL 예시: https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png