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

{
  "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