APIMaster.ai

Kling Image 4.0 · API gambar

Kling Image 4.0 menghasilkan gambar mandiri, seri yang konsisten, halaman detail produk, dan visual web panjang.

Kling Image 4.0

Kling Image 4.0 menghasilkan gambar mandiri, seri yang konsisten, halaman detail produk, dan visual web panjang.

Endpoint

  • 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}

Parameter permintaan

Kolom Nilai
contents JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image.
contents[].text Sertakan satu prompt yang tidak kosong. Gunakan @id untuk menyebut aset tertentu.
contents[].id Pengenal unik untuk setiap referensi dalam permintaan.
contents[].url URL gambar publik atau Base64. JPG, JPEG, PNG, maksimum 30 MB per gambar, kedua sisi minimal 300 piksel, rasio 2:5–5:2.
contents[].element_id Pengenal elemen gambar milik akun Anda atau preset yang didukung. Dihitung sebagai satu referensi.
settings.result_type single, series. Bawaan single.
settings.n single → 1–9. Bawaan 1.
settings.series_amount series → 2–10 / auto (2–10). Bawaan 4.
settings.resolution single / series → 2k, 4k, 8k. Bawaan 2k. ecommerce / webpage → 1k, 2k. Bawaan 1k.
settings.aspect_ratio single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Bawaan auto.
settings.skill long-image-generation → ecommerce, webpage.
settings.length ecommerce → short, medium, long. Bawaan medium.
options.watermark_info.enabled boolean. Bawaan false. true → outputs[].watermark_url.
options.callback_url URL webhook opsional yang sudah terdaftar dan terverifikasi di akun APIMaster.
options.external_task_id ID korelasi opsional hingga 128 byte, dikembalikan bersama tugas.

Gambar biasa dan seri menerima total 10 referensi dan elemen. E-commerce memerlukan 1–3 refer_image. Halaman web menerima hingga satu referensi gaya dan satu referensi subjek.

Prompt biasa: 50.000 karakter Inggris atau 21.000 karakter non-Inggris. Gambar panjang: 166.000 atau 71.000. Untuk campuran, jumlah proporsi terhadap kedua batas maksimal 1.

Mode tunggal menghasilkan gambar independen. Seri dikembalikan secara berurutan dan berbagi group_id. Gambar panjang menghasilkan satu gambar lengkap. length khusus e-commerce dan mengatur sekitar 2–5, 6–10, atau 11–18 bagian.

Contoh

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

Hasil tugas

Simpan task_id dan periksa dengan akun yang sama. Saat berhasil, outputs berisi URL gambar beserta watermark_url dan group_id opsional. Saat gagal, baca 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"}]
}

Gunakan kembali Idempotency-Key untuk permintaan yang sama. Setelah waktu habis, periksa tugas awal.

Penagihan

Biaya dihitung dari gambar yang diterima pada tarif keluaran ditambah referensi pada tarif masukan. Lihat harga pelanggan di marketplace. Kling Image 4.0