Skip to content

Giao thức Callback ​

Tham số khác ​

Xem tài liệu chính thức tại https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice. Tham số giống nhau; khi tích hợp, bạn chỉ cần đổi tên miền yêu cầu và API key sang của chúng tôi.

Giao thức callback cho tác vụ bất đồng bộ ​

Với tác vụ bất đồng bộ (tạo ảnh / tạo video), nếu đặt callback_url khi tạo tác vụ, máy chủ sẽ chủ động gửi thông báo khi trạng thái tác vụ thay đổi.

Định dạng dữ liệu callback ​

json
{
  "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
      }
    ]
  }
}

Trạng thái tác vụ ​

Giá trị có thể của task_status:

  • submitted: đã gửi
  • processing: đang xử lý
  • succeed: thành công
  • failed: thất bại

Lưu ý ​

  • Khi tác vụ thất bại, task_status_msg hiển thị lý do (ví dụ kích hoạt kiểm duyệt nội dung của nền tảng)
  • Ví dụ URL ảnh: https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png