APIMaster.ai

Kling Image 4.0 · API tạo ảnh

Kling Image 4.0 tạo ảnh độc lập, bộ ảnh đồng nhất, trang chi tiết sản phẩm và ảnh thiết kế web dạng dài.

Kling Image 4.0

Kling Image 4.0 tạo ảnh độc lập, bộ ảnh đồng nhất, trang chi tiết sản phẩm và ảnh thiết kế web dạng dài.

Điểm cuối

  • POST https://apimaster.ai/v1/kling/kling-image-4.0/image-generation · single, series
  • POST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation · ecommerce, webpage
  • GET https://apimaster.ai/v1/kling/kling-image-4.0/tasks/{task_id}

Tham số yêu cầu

Trường Giá trị
contents JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image.
contents[].text Cung cấp đúng một lời nhắc không rỗng. Dùng @id để tham chiếu từng tư liệu.
contents[].id Mã định danh duy nhất cho mỗi tư liệu trong yêu cầu.
contents[].url URL ảnh công khai hoặc Base64. JPG, JPEG và PNG tối đa 30 MB mỗi ảnh, hai cạnh ít nhất 300 px, tỷ lệ từ 2:5 đến 5:2.
contents[].element_id Mã phần tử ảnh thuộc tài khoản của bạn hoặc mẫu có sẵn được hỗ trợ. Tính là một tham chiếu.
settings.result_type single, series. Mặc định single.
settings.n single → 1–9. Mặc định 1.
settings.series_amount series → 2–10 / auto (2–10). Mặc định 4.
settings.resolution single / series → 2k, 4k, 8k. Mặc định 2k. ecommerce / webpage → 1k, 2k. Mặc định 1k.
settings.aspect_ratio single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Mặc định auto.
settings.skill long-image-generation → ecommerce, webpage.
settings.length ecommerce → short, medium, long. Mặc định medium.
options.watermark_info.enabled boolean. Mặc định false. true → outputs[].watermark_url.
options.callback_url URL webhook tùy chọn, cần đăng ký và xác minh trước trong tài khoản APIMaster.
options.external_task_id Mã đối chiếu tùy chọn tối đa 128 byte, được trả về cùng tác vụ.

Ảnh thường và bộ ảnh nhận tối đa 10 tham chiếu và phần tử cộng lại. Thương mại điện tử cần 1–3 refer_image. Trang web nhận tối đa một ảnh phong cách và một ảnh chủ thể.

Lời nhắc thường hỗ trợ 50.000 ký tự tiếng Anh hoặc 21.000 ký tự khác. Ảnh dài hỗ trợ tương ứng 166.000 và 71.000. Với nội dung hỗn hợp, tổng tỷ lệ so với hai giới hạn tối đa là 1.

Chế độ đơn tạo ảnh độc lập. Các ảnh trong bộ trả về theo thứ tự và dùng chung group_id. Mỗi yêu cầu ảnh dài trả về một ảnh hoàn chỉnh. length chỉ áp dụng cho thương mại điện tử và chọn khoảng 2–5, 6–10 hoặc 11–18 phần.

Ví dụ

single

curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/image-generation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling-image-example-001" \
  -d '{"contents":[{"type":"prompt","text":"A blue ceramic cup in soft daylight"}],"settings":{"resolution":"2k","aspect_ratio":"1:1"}}'

series

{
  "contents": [
    {
      "type": "prompt",
      "text": "Create two coordinated studio photographs of the blue ceramic cup in @cup. Show a front view and a detail close-up."
    },
    {
      "type": "refer_image",
      "id": "cup",
      "url": "https://example.com/cup.png"
    }
  ],
  "settings": {
    "result_type": "series",
    "series_amount": 2,
    "resolution": "4k",
    "aspect_ratio": "3:4"
  },
  "options": {
    "watermark_info": {
      "enabled": true
    },
    "external_task_id": "campaign-cup-001"
  }
}

ecommerce

{
  "contents": [
    {
      "type": "prompt",
      "text": "Design a product detail page for @cup. Include a hero image, material details, and care instructions."
    },
    {
      "type": "refer_image",
      "id": "cup",
      "url": "https://example.com/cup.png"
    }
  ],
  "settings": {
    "skill": "ecommerce",
    "length": "short",
    "resolution": "1k"
  }
}

webpage

{
  "contents": [
    {
      "type": "prompt",
      "text": "Design a long product landing page for a ceramic cup collection."
    }
  ],
  "settings": {
    "skill": "webpage",
    "resolution": "2k"
  }
}

Kết quả tác vụ

Lưu task_id và truy vấn bằng cùng tài khoản. Khi thành công, outputs chứa URL từng ảnh cùng watermark_url và group_id nếu có. Khi thất bại, xem error.

curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "task_id": "task_example",
  "object": "image",
  "model": "kling-image-4.0",
  "status": "completed",
  "outputs": [{"type": "image", "url": "https://example.com/generated.png"}]
}

Dùng lại Idempotency-Key khi gửi lại cùng yêu cầu. Nếu hết thời gian chờ, truy vấn tác vụ ban đầu.

Tính phí

Phí gồm số ảnh giao theo giá đầu ra và số tư liệu theo giá đầu vào. Xem giá hiện hành trên danh mục mẫu. Kling Image 4.0