GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Tous les guides

· reAPI Team

Tutoriel Kling Image 4.0 Long Image

Apprends à utiliser Kling Image 4.0 Long Image sur reAPI pour créer des fiches produits e-commerce et des maquettes de pages web, avec les règles de mode, les identifiants de référence, les tarifs et les étapes de vérification.

Tutoriel Kling Image 4.0 Long Image

La plupart des générateurs d’images ne livrent qu’une seule image carrée ou 16:9 à la fois. Quand tu as besoin d’une fiche produit e-commerce complète ou d’une page d’atterrissage verticale continue, assembler six images fixes séparées brise presque toujours l’éclairage, les marges et la typographie à chaque jonction. Kling Image 4.0 Long Image résout ce problème en générant un seul grand PNG continu, de l’en-tête principal jusqu’au pied de page, en une seule requête.[1]

Ce tutoriel détaille le contrat exact sur reAPI pour les modes webpage et ecommerce, y compris les règles des images de référence, les mentions @id, la planification entre les résolutions 1K et 2K, les tarifs actuels par page sur reAPI vérifiés le 20 novembre 2026, ainsi que les vérifications de suivi et d’inspection nécessaires pour les grands fichiers PNG.[2]

Résumé rapide

  • Deux skills distincts : settings.skill est obligatoire sur chaque appel. Choisis webpage pour les maquettes de pages d’atterrissage à défilement complet (0 à 2 références facultatives, sans settings.length) ou ecommerce pour les fiches produits détaillées (1 à 3 photos refer_image obligatoires plus une profondeur short, medium ou long).[1]
  • Un grand PNG par tâche : La largeur de sortie est fixée à 1K (1 024 px) ou 2K (2 048 px), tandis que la hauteur verticale s’adapte aux sections de ton brief. Le format 4k n’est pas pris en charge.[2]
  • Les rôles de référence ne peuvent pas être mélangés : refer_image fonctionne uniquement en mode ecommerce ; style_refer_image et subject_refer_image fonctionnent uniquement en mode webpage. Les références d’éléments ne sont pas prises en charge.[2]
  • Facturation à la page : Selon les tarifs vérifiés le 20 novembre 2026, les prix reAPI vont de 0,2269 $US (ecommerce, short, 1k) à 0,8319 $US (ecommerce, long, 2k), avec webpage à 0,5294 $US (1k) ou 0,5748 $US (2k), plus 0,003025 $US par image de référence en entrée dès la première. Consulte le tableau des tarifs en direct.[3]
  • Prévois des rendus longs et des fichiers volumineux : Les rendus multi-sections prennent généralement plusieurs minutes, et les grands PNG 2K peuvent dépasser 50 Mo. Dimensionne tes délais d’attente HTTP et tes visionneuses d’images en conséquence.[2]

Commencer par un brief de page web en 1K

Avant d’importer plusieurs photos de produit ou de payer pour une longue mise en page en 2K, envoie une seule requête webpage uniquement textuelle à Kling Image 4.0 Long Image en largeur 1K. Une tâche webpage en 1K te permet de vérifier le rythme vertical des sections, le contraste des couleurs et la hiérarchie visuelle sans consacrer de temps supplémentaire à la haute résolution ni à la configuration de références.

Liste chaque section dans l’ordre exact de haut en bas dans un seul élément prompt. Nomme la bannière principale, les bandes de fonctionnalités intermédiaires, toute grille ou bande de comparaison, et le bloc final de pied de page. Une demande vague comme « crée un site de café moderne » laisse le nombre de sections et le rythme visuel au hasard, alors qu’un plan vertical numéroté te fournit une grille de contrôle concrète lors de l’examen du résultat.

curl https://reapi.ai/api/v1/images/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-image-4-0-long-image",
    "contents": [
      {
        "type": "prompt",
        "text": "Design a tall landing page for a specialty coffee roastery. Section 1: full-bleed hero banner with warm morning light over a pour-over bar and headline space on the left. Section 2: three single-origin bean cards with origin notes and roast level tags. Section 3: brewing guide strip showing grind size, water temperature, and pour timing. Section 4: minimal footer with cafe address and opening hours."
      }
    ],
    "settings": {
      "skill": "webpage",
      "resolution": "1k"
    }
  }'

Le point de terminaison renvoie un objet JSON contenant l’id de ta tâche et status: "processing". Enregistre immédiatement cet identifiant. Contrairement aux points de terminaison d’images simples qui se terminent en dix secondes, une mise en page continue multi-sections demande plus de temps de rendu. Interroge GET /api/v1/tasks/{id} avec la même clé Bearer jusqu’à ce que status passe à completed ou failed.[4]

Choisir le mode ecommerce ou webpage dans Kling Image 4.0 Long Image

Chaque requête adressée à Kling Image 4.0 Long Image exige settings.skill. Le choix du bon mode est essentiel, car chaque skill impose ses propres types de références et contrôles de longueur, et les mélanger déclenche une erreur de validation avant toute facturation.[2]

RègleMode ecommerceMode webpage
Sortie cibleFiche produit détaillée multi-sectionsMaquette visuelle de page web à défilement complet
Types de références autorisésrefer_image uniquementstyle_refer_image et subject_refer_image uniquement
Nombre de références1 à 3 obligatoires0 à 1 style et 0 à 1 sujet (les deux facultatifs)
settings.lengthshort, medium (par défaut) ou longIgnoré (à omettre de la requête)
settings.resolution1k (par défaut) ou 2k1k (par défaut) ou 2k
options.watermark_info.enabledfalse uniquementfalse uniquement

Utilise le mode ecommerce dans Kling Image 4.0 Long Image dès que tu disposes de vraies photos produit et que tu as besoin d’une planche verticale cohérente pour une boutique en ligne. Les trois paliers de longueur correspondent à des nombres approximatifs de sections documentés par le créateur : short vise environ 2 à 5 sections, medium environ 6 à 10 sections et long environ 11 à 18 sections.[1]

Utilise le mode webpage dans Kling Image 4.0 Long Image lorsque tu prototypes une page d’atterrissage de marque, une page de lancement ou un microsite éditorial, en partant uniquement de texte ou en associant une référence de style visuelle à une photo du sujet principal. Comme le mode webpage détermine la hauteur verticale à partir de ta liste de sections plutôt que d’une énumération length, omettre settings.length garde tes requêtes propres et conformes au schéma.

Raccorder les références nommées sans casser la validation

Les images de référence sont le levier principal pour garder un vrai produit reconnaissable tout au long d’un défilement Kling Image 4.0 Long Image. Chaque élément de référence dans contents prend un type, une url HTTP ou HTTPS accessible publiquement et un id unique facultatif. Les chaînes Base64 et les URI data: sont rejetées par la passerelle reAPI.[2]

Chaque fichier de référence doit satisfaire quatre vérifications de format avant l’envoi :

  • Format : JPEG ou PNG uniquement.
  • Taille de fichier : Au maximum 30 Mo par image.
  • Dimensions minimales : Au moins 300 pixels en largeur comme en hauteur.
  • Rapport largeur/hauteur : Entre 2:5 et 5:2.

Teste chaque lien de référence dans une fenêtre de navigateur déconnectée avant d’appeler le point de terminaison. Les URL de ressources protégées par des cookies de tableau de bord expirants échouent lorsque le worker de rendu tente de les récupérer.

Exemple de fiche produit e-commerce

En mode ecommerce de Kling Image 4.0 Long Image, fournis entre une et trois entrées refer_image et attribue à chaque angle un id court et explicite, tel que front et spout. Cite ces noms directement sous la forme @front et @spout dans le prompt pour que la mise en page sache quelle photo ancre la bannière principale et laquelle pilote une bande de détail en gros plan.

{
  "model": "kling-image-4-0-long-image",
  "contents": [
    {
      "type": "refer_image",
      "url": "https://example.com/kettle-front.png",
      "id": "front"
    },
    {
      "type": "refer_image",
      "url": "https://example.com/kettle-spout.jpg",
      "id": "spout"
    },
    {
      "type": "prompt",
      "text": "Build a medium ecommerce product detail page for the brushed-steel gooseneck kettle in @front. Section 1: full-bleed hero showing @front on warm travertine stone with clean headline space. Section 2: three core benefit callouts covering pour precision, balanced handle ergonomics, and stainless body durability. Section 3: close-up detail band highlighting the curved spout from @spout with flow-control annotations. Section 4: morning pour-over brewing lifestyle scene. Section 5: care instructions and verified specification list."
    }
  ],
  "settings": {
    "skill": "ecommerce",
    "length": "medium",
    "resolution": "2k"
  }
}

Exemple de référence de style et de sujet pour page web

En mode webpage de Kling Image 4.0 Long Image, sépare la direction artistique du produit lui-même. Joins au maximum une style_refer_image pour guider la palette de couleurs, le rythme de grille et l’esprit typographique, et au maximum une subject_refer_image pour préserver la fidélité d’un objet physique. Chaque id de la requête doit être unique.

{
  "model": "kling-image-4-0-long-image",
  "contents": [
    {
      "type": "style_refer_image",
      "url": "https://example.com/editorial-grid.png",
      "id": "layout"
    },
    {
      "type": "subject_refer_image",
      "url": "https://example.com/watch.jpg",
      "id": "watch"
    },
    {
      "type": "prompt",
      "text": "Design a tall watch launch webpage that matches the pale sandstone palette and editorial grid rhythm of @layout while showcasing @watch. Section 1: hero header featuring @watch at center-right. Section 2: three-column craft overview covering case finish, crystal clarity, and strap taper. Section 3: close-up dial and lug detail strip. Section 4: full technical specifications grid and clean minimal footer."
    }
  ],
  "settings": {
    "skill": "webpage",
    "resolution": "2k"
  }
}

Surveille la limite pondérée du prompt lorsque tu rédiges de longs briefs. Kling Image 4.0 Long Image accepte jusqu’à 166 000 caractères anglais ou 71 000 caractères non anglais, les textes multilingues étant soumis à la contrainte english / 166000 + non_english / 71000 <= 1. Cette limite est vérifiée de nouveau après la conversion des noms @id en marqueurs positionnels : garde donc une petite marge de sécurité si ton prompt approche du plafond.[2]

Planifier les budgets entre 1K, 2K et les paliers de longueur

Contrairement aux générateurs d’images fixes standard qui facturent par tuile produite, Kling Image 4.0 Long Image facture chaque requête terminée au tarif d’un palier de sortie plus des frais pour chaque image de référence en entrée (y compris la première référence). Les générations échouées qui ne livrent aucune sortie libèrent automatiquement leurs crédits réservés.[2]

Le tableau ci-dessous présente les tarifs reAPI en vigueur vérifiés le 20 novembre 2026 (1 crédit = 0,001 $US, 1 $US = 1 000 crédits). Vérifie toujours les tarifs actifs sur la page tarifaire de Kling Image 4.0 Long Image avant de lancer de gros lots.[3]

PalierRésolutionTarif reAPI (vérifié le 20 nov. 2026)Usage type
ecommerce · short1k / 2k0,2269 $US / 0,2723 $USRésumé produit compact de 2 à 5 sections
ecommerce · medium1k / 2k0,4538 $US / 0,5294 $USFiche boutique standard de 6 à 10 sections
ecommerce · long1k / 2k0,7563 $US / 0,8319 $USPlanche produit phare complète de 11 à 18 sections
webpage1k / 2k0,5294 $US / 0,5748 $USPage d’atterrissage ou maquette de campagne à défilement complet
Image de référence en entréeToute0,003025 $US chacunFacturé une fois par photo de référence fournie

Voici un exemple de calcul concret à partir de ces tarifs du 20 novembre 2026 : une requête ecommerce medium 2k avec deux photos produit revient à 0,5294 $US + 2 × 0,003025 $US = 0,53545 $US. À l’envoi, reAPI réserve ceil(0.53545 × 1000) = 536 crédits entiers, puis règle à l’achèvement au microdollar exact et recrédite l’écart fractionnaire sur ton solde.[2]

Une méthode pratique pour maîtriser les dépenses sur Kling Image 4.0 Long Image consiste à travailler en deux passes. Ébauche l’ordre de mise en page et le texte des sections en 1k (ou en ecommerce short 1k pour valider d’abord la fidélité du produit), inspecte chaque bandeau et ne passe en 2k qu’une fois la séquence visuelle validée.

Suivre de façon fiable et inspecter les grands PNG

Après avoir envoyé une requête Kling Image 4.0 Long Image, interroge GET /api/v1/tasks/{id} à intervalle régulier, par exemple toutes les 5 à 10 secondes, avec un budget de délai d’attente côté client d’au moins 15 à 20 minutes pour les tâches long + 2k. Ne relance pas automatiquement POST /v1/images/generations lorsqu’une requête de suivi connaît un incident passager : chaque nouveau POST crée une nouvelle tâche facturable.[4]

Lorsque status atteint completed, lis l’URL unique dans output.image_urls[0] et copie immédiatement le PNG vers ton propre stockage. Comme les longues mises en page en 2K peuvent dépasser 50 Mo et s’étendre sur plus de 15 000 pixels en hauteur, télécharge en flux vers le disque plutôt que de mettre en tampon des fichiers entiers dans la mémoire limitée d’une fonction serverless, puis inspecte le résultat en deux passes :

  1. Balayage en vignette pleine hauteur : Dézoome pour vérifier le rythme visuel, la cohérence des couleurs de haut en bas et la netteté des séparations entre sections.
  2. Contrôle section par section à 100 % : Vérifie le titre principal, les silhouettes du produit, les finitions des matériaux, les libellés des repères et le bloc de caractéristiques inférieur à l’échelle native des pixels.

N’inclus dans ton brief que des dimensions produit, conditions de garantie et caractéristiques techniques vérifiées. La relecture du texte à zoom 100 % permet de repérer les chiffres déformés ou les caractères manquants avant qu’une maquette n’entre en découpage boutique ou en intégration front-end.

Foire aux questions

Puis-je générer une page verticale 4K avec Kling Image 4.0 Long Image ?

Non. Kling Image 4.0 Long Image ne prend en charge que les sorties 1k (1 024 px de large) et 2k (2 048 px de large). Les requêtes demandant 4k sont rejetées par une erreur de validation avant toute réservation de crédits. Pour des images fixes individuelles ou des séries multi-plans en 4K, utilise Kling Image 4.0.

Pourquoi ma requête ecommerce a-t-elle échoué à la validation avec zéro référence ?

Le mode ecommerce exige entre 1 et 3 éléments refer_image dans contents afin que le modèle puisse ancrer chaque section verticale sur de vraies photos produit. Si tu veux générer une mise en page verticale uniquement à partir de texte, définis settings.skill sur webpage.

Puis-je combiner refer_image et style_refer_image dans une même requête ?

Non. Les rôles de référence sont strictement séparés selon le mode : ecommerce accepte uniquement refer_image, tandis que webpage accepte uniquement style_refer_image et subject_refer_image. Le Playground bloque le mélange avant l’envoi ; via un appel API direct, la requête peut d’abord réserver des crédits puis échouer de manière asynchrone lors du traitement, avec remboursement automatique des crédits réservés.

La première image de référence est-elle prise en compte dans la facturation ?

Oui. Chaque image de référence en entrée fournie dans contents est facturée une fois sur une tâche terminée, dès la première image. Les tâches échouées sans sortie libèrent automatiquement leurs crédits réservés.

En quoi Kling Image 4.0 Long Image diffère-t-il de Kling Image 4.0 ?

Kling Image 4.0 Long Image produit un seul grand PNG continu conçu pour les fiches produits e-commerce verticales et les mises en page de pages web. Kling Image 4.0 produit des images fixes au format standard (jusqu’à 9 propositions indépendantes ou une série de 2 à 10 plans) en 2K ou 4K.

Comment gérer le téléchargement de grands PNG de 50 Mo ?

Configure des délais d’attente de téléchargement HTTP supérieurs à 60 secondes, transfère directement les octets de la réponse en flux vers un stockage objet ou sur disque, et vérifie Content-Length ou les dimensions du PNG après téléchargement avant d’exécuter tes scripts de découpage d’image.

Passer en production avec Kling Image 4.0 Long Image

Commence par tester un prompt webpage en 1k dans l’environnement d’essai Kling Image 4.0 Long Image pour valider le rythme des sections et l’équilibre visuel. Une fois que le plan vertical correspond à la structure de ta boutique ou de ta campagne, fige tes URL de référence, suis le schéma de la documentation API Kling Image 4.0 Long Image et mets en place un pipeline reproductible de suivi et de découpage autour de output.image_urls[0].

Références

  1. Kling AI, Kling Image 4.0 Long Image Generation API — spécifications officielles des skills ecommerce et webpage, recommandations de paliers de longueur et limites de références.
  2. reAPI, documentation API Kling Image 4.0 Long Image — schéma de requête, contraintes des références HTTP(S), limites pondérées de prompt, schéma de sortie et mécanismes de facturation.
  3. reAPI, page modèle et tarifs en direct de Kling Image 4.0 Long Image — tarifs actuels par palier de sortie et par référence vérifiés le 20 novembre 2026.
  4. reAPI, référence API Tasks — suivi asynchrone des tâches, états terminaux et gestion des erreurs.

Plus d'articles

Tous les guides