APIMaster.ai

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

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