Kling Image 4.0 · API d’images
Kling Image 4.0 génère des images indépendantes, des séries cohérentes, des fiches produit et des visuels de pages web longues.
Kling Image 4.0
Kling Image 4.0 génère des images indépendantes, des séries cohérentes, des fiches produit et des visuels de pages web longues.
Points d’accès
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}
Paramètres de requête
| Champ | Valeur |
|---|---|
contents |
JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image. |
contents[].text |
Fournissez un seul prompt non vide. Utilisez @id pour désigner chaque référence. |
contents[].id |
Identifiant unique de chaque référence dans la requête. |
contents[].url |
URL publique ou Base64. JPG, JPEG ou PNG, jusqu’à 30 Mo par image, au moins 300 px sur chaque côté, ratio de 2:5 à 5:2. |
contents[].element_id |
Identifiant d’un élément image de votre compte ou d’un préréglage compatible. Compte comme une référence. |
settings.result_type |
single, series. Par défaut single. |
settings.n |
single → 1–9. Par défaut 1. |
settings.series_amount |
series → 2–10 / auto (2–10). Par défaut 4. |
settings.resolution |
single / series → 2k, 4k, 8k. Par défaut 2k. ecommerce / webpage → 1k, 2k. Par défaut 1k. |
settings.aspect_ratio |
single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Par défaut auto. |
settings.skill |
long-image-generation → ecommerce, webpage. |
settings.length |
ecommerce → short, medium, long. Par défaut medium. |
options.watermark_info.enabled |
boolean. Par défaut false. true → outputs[].watermark_url. |
options.callback_url |
URL de webhook facultative, enregistrée et vérifiée sur votre compte APIMaster. |
options.external_task_id |
Identifiant de corrélation facultatif, au plus 128 octets, renvoyé avec la tâche. |
Les images et séries acceptent 10 références et éléments au total. Une fiche produit exige 1–3 refer_image. Une page web accepte une référence de style et une de sujet.
Prompt ordinaire : 50 000 caractères anglais ou 21 000 non anglais. Image longue : 166 000 ou 71 000. Pour un texte mixte, la somme des fractions par rapport aux deux plafonds doit rester inférieure ou égale à 1.
Le mode individuel produit des images indépendantes. Les images d’une série sont ordonnées et partagent un group_id. Chaque requête d’image longue livre une image complète. length concerne les fiches produit et correspond à environ 2–5, 6–10 ou 11–18 sections.
Exemples
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"
}
}
Résultats de la tâche
Conservez task_id et interrogez la tâche avec le même compte. outputs contient les URL des images et les champs facultatifs watermark_url et group_id. En cas d’échec, lisez 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"}]
}
Réutilisez Idempotency-Key pour une même requête. Après expiration du délai, interrogez la tâche initiale.
Facturation
La facture additionne les images livrées au tarif de sortie et les références au tarif d’entrée. Les tarifs clients sont indiqués dans le catalogue. Kling Image 4.0
