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,seriesPOST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation·ecommerce,webpageGET 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
