Tutoriel Kling Image 4.0 Long Image
Crée des pages web et fiches produit 2K avec Kling Image 4.0 Long Image : deux essais PNG réels, requêtes cURL, suivi de tâche et tarifs en direct.
Lire en MarkdownLes modèles d’image classiques génèrent un visuel à la fois. Dès que tu leur demandes une fiche produit complète ou une page de lancement entière, tu finis par empiler six bannières indépendantes et par rattraper des marges bancales, des polices qui dérivent et des échelles produit incohérentes dans un outil de mise en page. Kling Image 4.0 Long Image fonctionne autrement : une seule requête API renvoie un PNG vertical continu structuré de haut en bas, avec une largeur fixe en 1K (1024 px) ou 2K (2048 px) et une hauteur déterminée par les sections décrites dans ton brief.
Le 19 novembre 2026, nous avons lancé deux tâches 2K sur l’endpoint SeedRouter /v1/images/generations pour évaluer les deux modes sur des briefs concrets de production. Le premier essai utilisait le mode webpage à partir de texte seul et a produit une page de lancement de 2048 × 16 385 px pour une marque fictive de casques de studio (17 Mo, 169 secondes). Le second essai exploitait le mode ecommerce en longueur medium avec deux photos de joaillerie existantes et a généré une fiche produit de 2048 × 19 533 px (25 Mo, 261 secondes). Tu peux examiner les deux planches complètes ci-dessous, tester l’un ou l’autre brief dans le Playground Kling Image 4.0 Long Image et vérifier les tarifs exacts par palier dans le tableau en direct plus bas.
Choisis ecommerce ou webpage avant d’écrire une ligne
Le champ settings.skill est obligatoire : il change à la fois la grammaire visuelle de la mise en page et les paramètres acceptés par l’API. Aborde ces deux modes comme deux contrats distincts plutôt que comme de simples styles esthétiques.
Utilise ecommerce quand tu disposes déjà de vraies photos produit et que tu veux une fiche produit verticale (PDP) pour une boutique ou une marketplace. En mode ecommerce, tu dois envoyer entre une et trois entrées refer_image dans contents, et tu pilotes le nombre de sections verticales via settings.length (short, medium ou long, avec medium par défaut). Toute requête sans photo produit de référence est rejetée avant facturation.
Utilise webpage lorsque tu conçois une landing page de marque, un site de lancement ou une page web éditoriale. En mode webpage, les références sont facultatives : tu peux partir uniquement d’un brief texte, ou fournir au plus une style_refer_image pour guider la palette et le rythme de grille, et au plus une subject_refer_image pour ancrer un produit central. N’envoie ni refer_image ni settings.length en mode webpage : ces deux paramètres sont réservés aux requêtes ecommerce et déclenchent une erreur de validation s’ils sont mélangés.
| Paramètre ou entrée | Mode ecommerce | Mode webpage |
|---|---|---|
settings.skill | "ecommerce" (requis) | "webpage" (requis) |
settings.length | "short", "medium" (par défaut) ou "long" | À omettre complètement |
settings.resolution | "1k" (1024 px de large) ou "2k" (2048 px de large) | "1k" (1024 px de large) ou "2k" (2048 px de large) |
Entrées refer_image | Requis : 1 à 3 URL publiques JPEG/PNG | Non autorisé |
style_refer_image / subject_refer_image | Non autorisé | Facultatif : jusqu’à 1 de chaque |
Aucun des deux modes n’accepte 4k, un nombre de lots (n) ou un ratio personnalisé. Chaque tâche réussie renvoie exactement une URL de PNG vertical dans output.data[0].url.
Essai 1 : une maquette de page web 2K générée par texte seul (2048 × 16 385)

Voici les quatre quarts verticaux de notre essai webpage en 2K placés côte à côte. Le brief demandait une page de lancement au style industriel suisse sur fond noir obsidienne pour un casque planaire ouvert baptisé S-01 Reference Planar : une barre supérieure minimaliste, un visuel héro trois-quarts, un bandeau d’atouts acoustiques en trois colonnes, une vue éclatée d’usinage CNC, un tableau de caractéristiques techniques chiffrées et un pied de page sobre.
Regarde de près ce qui a tenu sur une seule passe continue. Sur 16 385 pixels de hauteur, le fond anthracite sombre, les titres à empattements et la géométrie en aluminium brossé du casque restent cohérents de la barre de navigation jusqu’au bandeau des cinq coloris et au tableau technique. Toutes les valeurs électriques demandées sont sorties lisibles (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). Un détail mérite tout de même d’être signalé après inspection du PNG à 100 % : le prompt demandait un bandeau albâtre clair derrière le tableau de spécifications, mais le modèle a gardé le tableau sur ardoise foncée et a déplacé la bande gris clair sur le bloc newsletter juste en dessous. Si un changement de fond précis sur une section donnée est impératif pour l’intégration, sers-toi du rendu comme direction artistique et découpe ou reconstruis la section en HTML à partir des visuels générés.
Rédiger un bon brief webpage ressemble davantage à un plan de wireframe qu’à un prompt photo classique. Pose d’abord les jetons de design globaux (code hexadécimal du fond, matériaux, couleur d’accent, discipline de grille), puis numérote chaque bloc de haut en bas avec les titres exacts et les chiffres clés en anglais. Si tu laisses les titres vagues, le modèle comble avec du texte générique.
curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [{
"type": "prompt",
"text": "Design a vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
}],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}' -o solstice-task.json
jq -er '.id' solstice-task.jsonRemarque que settings.length est absent de ce payload et que contents ne comporte que l’entrée prompt. Tu peux consulter le contrat complet des paramètres dans la référence API Kling Image 4.0 Long Image. [1]
Essai 2 : une fiche produit e-commerce 2K avec deux références (2048 × 19 533)

Pour le second essai, nous avons basculé settings.skill sur "ecommerce", réglé settings.length sur "medium", conservé resolution à "2k" et fourni deux photos de joaillerie existantes en refer_image : un gros plan macro d’une boucle d’oreille pendante orchidée en or sculpté avec id: "earring", et un portrait éditorial dans une serre d’une femme portant cette même boucle avec id: "model".
Dans le prompt, nous avons désigné ces deux visuels par @earring et @model au fil des sections. L’API convertit automatiquement tes identifiants nommés en références positionnelles, sans que tu aies à compter les indices à la main. Chaque photo de référence doit être une URL publique JPEG ou PNG de 30 Mo maximum, d’au moins 300 px par côté, avec un ratio compris entre 2:5 et 5:2.

Cet unique appel 2K de longueur moyenne a généré 19 533 pixels de hauteur couvrant six modules e-commerce complets : un visuel héro sur soie champagne, un bandeau poétique sur l’inspiration créative, un détourage studio accompagné d’un tableau produit sur six lignes (Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), un portrait On The Ear fidèle à @model, une grille produit sous six angles (Front, Side, Back, Core Detail, Hook Detail, Profile), ainsi que le schéma annoté Craft And Beauty détaillé ci-dessus.
La vérification en pleine résolution a aussi mis en évidence un défaut utile à connaître avant de publier des fiches générées directement en catalogue. Alors que le tableau technique affichait exactement Phalaenopsis No. 4 Drop Earring et que toutes les annotations étaient orthographiées sans faute, la bannière héro en tête de page a raccourci Botanical Series en BOTA SERIES et BOTA — Drop Earring au lieu d’imprimer le nom de marque demandé L'ORCHIDÉE. C’est un comportement classique sur les textes de pages longues : les libellés courts et les lignes de tableaux restent très stables, mais les logos stylisés tout en majuscules en haut de page peuvent parfois dériver. Contrôle toujours le titre héro à pleine largeur et garde les logos officiels ou mentions légales en surcouche vectorielle dans le gabarit de ta boutique.
curl --fail-with-body -sS https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [
{
"type": "prompt",
"text": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
},
{
"type": "refer_image",
"id": "earring",
"url": "https://example.com/assets/gold-orchid-earring.png"
},
{
"type": "refer_image",
"id": "model",
"url": "https://example.com/assets/editorial-portrait.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}' -o orchidee-task.json
jq -er '.id' orchidee-task.jsonSi tu utilises plutôt des références en mode webpage, garde une règle simple en tête : associe style_refer_image à la direction esthétique et subject_refer_image au produit principal, en donnant à chacun un id alphanumérique distinct (de 1 à 32 caractères, sans espace) puis en le mentionnant avec @id dans le prompt. Ne duplique jamais un même id dans un tableau contents.
Interroge la tâche avec patience et anticipe les PNG 2K volumineux
Les mises en page verticales prennent nettement plus de temps que des générations d’images classiques et produisent des fichiers beaucoup plus lourds. Les traiter comme une API de vignettes de cinq secondes est le meilleur moyen de provoquer des timeouts client ou une double facturation accidentelle.
Lors de nos essais du 19 novembre, la page web 2048 × 16 385 s’est terminée en 169 secondes (17 Mo), et la fiche e-commerce medium de 2048 × 19 533 en 261 secondes (25 Mo). Une fiche e-commerce long en 2K peut dépasser sept minutes et 50 Mo. Sauvegarde l’ID de tâche immédiatement après le retour de POST /v1/images/generations, interroge GET /v1/tasks/{id} toutes les 15 à 20 secondes, et ne renvoie jamais un second POST simplement parce qu’une session terminal a coupé ou qu’un client a expiré. [2]
TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.jsonDès que status passe à completed, extrais l’unique URL PNG dans output.data[0].url et télécharge-la sur disque avec un délai de transfert généreux :
IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.pngDans tes workers backend, évite de charger tout le PNG dans un petit tampon mémoire fixe avant de l’écrire sur disque ou vers un stockage objet. Streame directement le corps de la réponse HTTP dans un fichier, vérifie ses dimensions avant de découper les sections pour une boutique mobile, et convertis les aperçus d’affichage en WebP tout en gardant le PNG d’archive pour l’impression ou les exports par tranches.
Estime ton budget sur les huit paliers et les images de référence
La tarification de Kling Image 4.0 Long Image repose sur trois choix : skill (ecommerce ou webpage), length (short, medium ou long en mode e-commerce) et resolution (1k ou 2k). Chaque image de référence envoyée en entrée (refer_image, style_refer_image ou subject_refer_image) ajoute des frais d’image d’entrée, dès la première photo et sans quota inclus.
La méthode d’itération en découle naturellement. Pour caler l’ordre des sections, le rythme des titres et la hiérarchie des couleurs d’un catalogue e-commerce, commence tes tests en 1k short ou medium, contrôle le déroulé vertical, puis passe en 2k une fois le brief stabilisé. En mode page web, l’écart entre 1k et 2k reste assez mesuré pour choisir 2k dès que tu veux des tableaux de spécifications parfaitement nets en petit corps. Notre premier essai a été facturé au tarif exact webpage 2K ; le second au tarif ecommerce medium 2K plus deux images de référence. Une requête échouée n’est pas facturée. Consulte les tarifs actuels ci-dessous ou saisis tes paramètres exacts dans le calculateur de prix Kling Image 4.0 Long Image. [3]
Combien coûte Kling Image 4.0 Long Image
| Catégorie | Tarifs (USD) |
|---|---|
| E-commerce · 1K · court | 0,2269 $US |
| E-commerce · 2K · court | 0,2723 $US |
| E-commerce · 1K · moyen | 0,4538 $US |
| E-commerce · 2K · moyen | 0,5294 $US |
| E-commerce · 1K · long | 0,7563 $US |
| E-commerce · 2K · long | 0,8319 $US |
| Page web · 1K | 0,5294 $US |
| Page web · 2K | 0,5748 $US |
| Image de référence | 0,003025 $US |
Questions fréquentes
Comment choisir entre short, medium et long en mode ecommerce ?
Compte les modules réellement nécessaires à ton produit avant de fixer length. Une page short convient à trois ou quatre bandeaux ciblés : visuel héro, bénéfices clés et bloc technique compact. Une page medium accueille confortablement six sections, comme l’essai joaillerie ci-dessus (héro, storytelling, détourage studio, tableau technique, photo portée, grille multi-angles et schéma annoté). Réserve long aux produits techniques ou fiches multi-références qui exigent des tableaux comparatifs, des étapes d’utilisation et le détail du coffret sans tasser la typographie.
Pourquoi ma requête webpage renvoie-t-elle HTTP 400 ?
Les deux erreurs de validation les plus fréquentes consistent à envoyer settings.length avec skill: "webpage" et à déclarer une image de référence avec type: "refer_image" au lieu de style_refer_image ou subject_refer_image. Ces deux champs sont exclusifs au mode ecommerce. Vérifie aussi que le prompt respecte la limite pondérée de caractères (en / 166000 + non_en / 71000 <= 1, contrôlée après résolution des mentions @id) et que resolution vaut bien "1k" ou "2k".
Faut-il découper le PNG final pour une boutique en ligne en production ?
Oui. Un PNG de 2048 × 19 533 pèse entre 17 et 25 Mo non compressé : c’est beaucoup trop lourd pour être servi dans une seule balise <img> sur réseau mobile. Découpe l’image finale le long des transitions horizontales entre bandeaux, compresse chaque tranche en WebP ou AVIF pour un chargement progressif rapide, et remplace les mentions légales, prix ou boutons d’achat critiques par du vrai texte HTML. Tu peux tester tes prompts et examiner des rendus pleine hauteur directement dans le Playground Kling Image 4.0 Long Image avant d’automatiser ton pipeline.



