Claude Opus 5.5 est disponible sur SeedRouter

Image

Kling Image 4.0

View Markdown

Crée des images en 2K ou 4K avec Kling Image 4.0. Utilise des photos de référence nommées pour générer des variations d’une même image ou une série cohérente, puis interroge l’état de la tâche jusqu’à obtenir les URL des images terminées.

Envoie une requête JSON à POST /v1/images/generations avec l’ID de modèle kling-image-4-0. Enregistre l’ID de tâche renvoyé. Le même endpoint accepte les descriptions textuelles seules et celles guidées par des images de référence.

Exemple rapide

Cette requête génère une image fixe carrée en 2K. Stocke ta clé API dans la variable d’environnement SEEDROUTER_API_KEY.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-image-4-0",
    "contents": [
      {"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
    ],
    "settings": {"resolution": "2k", "aspect_ratio": "1:1"}
  }'

Endpoint et en-têtes

Envoie du JSON à POST https://api.seedrouter.ai/v1/images/generations avec Content-Type: application/json et Authorization: Bearer YOUR_API_KEY. Garde la clé sur ton serveur.

Paramètres

ChampTypeValeurs et valeurs par défaut
modelchaîne, obligatoirekling-image-4-0
contentstableau, obligatoireUne description et zéro à dix images de référence.
contents[].typechaîne, obligatoireprompt ou refer_image.
contents[].textchaîneObligatoire pour la description. Limite de 50 000 caractères en anglais et de 21 000 caractères dans les autres langues. Dans un texte multilingue, la somme des fractions utilisées de chaque limite ne doit pas dépasser un.
contents[].urlchaîneObligatoire pour chaque référence. Utilise une URL HTTP(S) accessible vers une image JPEG ou PNG de 30 Mo maximum. Les deux côtés doivent mesurer au moins 300 pixels et le rapport largeur/hauteur doit être compris entre 2:5 et 5:2.
contents[].idchaîneNom facultatif et unique pour une référence. Mentionne ce nom sous la forme @name dans la description.
settings.result_typechaînesingle (par défaut) pour des images indépendantes, ou series pour des images liées.
settings.nentier1 à 9 images indépendantes. Valeur par défaut : 1. Utilisé uniquement en mode single.
settings.series_amountentier ou chaîneEn mode series, de 2 à 4 images, avec 4 par défaut. En mode single, ce champ est ignoré et peut être un entier de 2 à 10 ou la chaîne auto.
settings.resolutionchaîne2k (par défaut) ou 4k.
settings.aspect_ratiochaîneauto (par défaut), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 ou 21:9.
options.watermark_info.enabledbooléenFacultatif. Seule la valeur false est prise en charge.

Une série à partir d’une photo de référence

Remplace l’URL d’exemple par une URL publique de la photo de ton produit. Cet exemple demande trois images liées. Garde l’instruction de chaque image dans la même description.

{
  "model": "kling-image-4-0",
  "contents": [
    {"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
    {"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
  ],
  "settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}

Récupérer toutes les images

Copie l’id de la réponse POST dans TASK_ID. Interroge cet endpoint avec la même clé jusqu’à ce que l’état de la tâche soit completed ou failed.

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Une fois la tâche terminée, récupère toutes les URL dans output.data[].url. Une tâche peut renvoyer plusieurs images. Si une vérification d’état est interrompue, consulte de nouveau l’ID d’origine. Consulte la référence des tâches pour leur cycle de vie et le répertoire des erreurs pour les codes d’erreur.

Tarifs

Le total correspond au nombre d’images générées à la résolution demandée, multiplié par le tarif en vigueur par image, auquel s’ajoute un frais de référence par image d’entrée. Quatre images en 4K avec deux références coûtent quatre frais de génération en 4K et deux frais de référence. Une requête échouée n’est pas facturée. Consulte les tarifs en vigueur.

Erreurs et conseils

Une entrée non valide renvoie une erreur de requête. Vérifie qu’il ne manque pas de texte dans la description, qu’il n’y a pas d’ID de référence en double et que les paramètres de résolution ou de série sont pris en charge. Si l’appel initial a renvoyé un ID de tâche, consulte cet ID avant de décider s’il faut envoyer une autre requête.

Pour une requête utilisant plusieurs références, attribue un nom distinct à chaque sujet et précise quelles caractéristiques visuelles chaque référence apporte. Indique les mouvements de caméra et l’ordre des plans dans la requête. Consulte le bac à sable Kling Image 4.0 et le schéma OpenAPI.