Open API

Xác thực

Tất cả yêu cầu đều cần bearer token. Tạo token từ trang tài khoản của bạn.

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Các mô hình khả dụng

Các giá trị model_id bên dưới là những giá trị duy nhất được open API chấp nhận.

Tạo tác vụ

Gửi yêu cầu sinh dữ liệu. Phản hồi trả về một task_id để bạn có thể kiểm tra tiến trình.

Nội dung yêu cầu

{
  "model_id": "gpt-image-2",
  "prompt": "a serene zen garden at sunrise, ultra detailed",
  "image_urls": [],
  "aspect_ratio": "16:9"
}

Ví dụ cURL

curl -X POST https://your-site.com/api/v1/tasks/create \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "gpt-image-2",
    "prompt": "a serene zen garden at sunrise",
    "aspect_ratio": "16:9"
  }'

Phản hồi

{
  "code": 200,
  "msg": "提交成功，等待生成",
  "data": {
    "task_id": "abcdef123456",
    "request_id": "kie_xxxxxxxxxxxx",
    "credits": 15
  }
}

Tín dụng sẽ bị trừ khi gửi yêu cầu. Các tác vụ thất bại sẽ được hoàn lại tự động.

Truy vấn tác vụ

Kiểm tra nhiệm vụ theo id cho đến khi task_status đạt 3 (thành công) hoặc 4 (thất bại).

Ví dụ cURL

curl https://your-site.com/api/v1/tasks/abcdef123456 \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Phản hồi

{
  "code": 200,
  "msg": "ok",
  "data": {
    "task_id": "abcdef123456",
    "task_status": 3,
    "task_type": "image",
    "model_id": "gpt-image-2",
    "image_url": "https://your-cdn.com/...",
    "video_url": null,
    "audio_url": null,
    "credits": 15,
    "created_at": 1730000000
  }
}

task_status: 1 đang xếp hàng, 2 đang chạy, 3 thành công, 4 thất bại.

Lỗi

• code: 200 — Thành công
• code: 0 — Lỗi nghiệp vụ (xem trường msg để biết chi tiết)
• HTTP 401 — API key không hợp lệ hoặc bị thiếu