APIMaster.ai

Kling Image 4.0 · Görsel API’si

Kling Image 4.0 bağımsız görseller, uyumlu seriler, ürün detay sayfaları ve uzun web tasarımları oluşturur.

Kling Image 4.0

Kling Image 4.0 bağımsız görseller, uyumlu seriler, ürün detay sayfaları ve uzun web tasarımları oluşturur.

Uç noktalar

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

İstek parametreleri

Alan Değer
contents JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image.
contents[].text Boş olmayan tek bir istem ekleyin. Belirli bir referans için @id kullanın.
contents[].id İstekteki her referansın benzersiz kimliği.
contents[].url Herkese açık görsel adresi veya Base64. JPG, JPEG ve PNG, görsel başına en fazla 30 MB, her kenar en az 300 px, oran 2:5–5:2.
contents[].element_id Hesabınıza ait görsel öğe kimliği veya desteklenen hazır öğe. Bir referans sayılır.
settings.result_type single, series. Varsayılan single.
settings.n single → 1–9. Varsayılan 1.
settings.series_amount series → 2–10 / auto (2–10). Varsayılan 4.
settings.resolution single / series → 2k, 4k, 8k. Varsayılan 2k. ecommerce / webpage → 1k, 2k. Varsayılan 1k.
settings.aspect_ratio single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Varsayılan auto.
settings.skill long-image-generation → ecommerce, webpage.
settings.length ecommerce → short, medium, long. Varsayılan medium.
options.watermark_info.enabled boolean. Varsayılan false. true → outputs[].watermark_url.
options.callback_url İsteğe bağlı webhook adresi. APIMaster hesabınızda önceden kaydedilmeli ve doğrulanmalıdır.
options.external_task_id Görevle geri dönen en fazla 128 baytlık isteğe bağlı ilişkilendirme kimliği.

Normal ve seri modlarda toplam 10 görsel referans ve öğe kullanılabilir. E-ticaret için 1–3 refer_image gerekir. Web sayfası birer biçem ve konu referansı kabul eder.

Normal istemde 50.000 İngilizce veya 21.000 İngilizce dışı karakter. Uzun görselde sınırlar 166.000 ve 71.000 karakterdir. Karışık metinde sınırlara oranların toplamı en fazla 1 olmalıdır.

Tekli mod bağımsız görseller üretir. Seri görselleri sıralıdır ve aynı group_id değerini paylaşır. Uzun görsel isteği tek bir tam görsel döndürür. length yalnızca e-ticaret içindir ve yaklaşık 2–5, 6–10 ya da 11–18 bölüm seçer.

Örnekler

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

Görev sonuçları

task_id değerini kaydedip aynı hesapla sorgulayın. Başarıda outputs görsel adresleriyle isteğe bağlı watermark_url ve group_id alanlarını içerir. Hata durumunda error alanına bakın.

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

Aynı isteği yinelerken aynı Idempotency-Key değerini kullanın. Süre dolarsa mevcut görevi sorgulayın.

Ücretlendirme

Ücret, teslim edilen görsellerin çıktı bedeli ile referansların girdi bedelinin toplamıdır. Güncel müşteri fiyatları pazaryerinde gösterilir. Kling Image 4.0