how-tos

Kling Image 4.0 API : images 8K natives et designs de pages web longues

Poyo.ai Team
9 min read
Share:

Kling Image 4.0 API : images 8K natives et pages web et e-commerce longues

Deux fonctionnalités distinguent la Kling Image 4.0 API : un palier de résolution 8K sur kling-4.0-image, le seul modèle d’image sur PoYo qui en dispose, et un modèle séparé, kling-4.0-long-image, qui conçoit une page web ou une page produit e-commerce entière sous forme d’une seule image haute. Cet article présente les corps de requête, ce que nous avons obtenu en les exécutant le jour du lancement et comment gérer les fichiers. Commencez par la page du modèle Kling Image 4.0 si vous voulez d’abord les essayer dans le playground.

8K natif avec la Kling Image 4.0 API

Dans son article de lancement, Kling indique que Kling Image 4.0 introduit la génération d’images en 8K natif : l’image est générée à cette taille au lieu d’être agrandie après coup. Sur PoYo, il suffit d’un champ :

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "A rider on a vintage motorbike crossing a desert highway at sunrise, long shadows, dust in the air, cinematic photography",
    "size": "16:9",
    "resolution": "8K",
    "n": 1
  }
}

Ce que renvoie une requête 8K

L’équipe PoYo a exécuté cette forme de requête (texte vers image, size: "16:9", resolution: "8K", n: 1) sur l’API de production le 19 novembre 2026 :

RésultatValeur
SortiePNG 10880×6144
Taille du fichierenviron 128 MB
Coût32 crédits ($0.16)
De la soumission au résultatenviron 3.8 minutes
Format de pixelRGBA (PNG avec canal alpha), bien que l’image soit opaque

Pour référence, la documentation PoYo indique en 1:1 des tailles de 2048×2048 en 2K et 8192×8192 en 8K, ainsi que 5440×3072 en 16:9 pour le 4K, avec des PNG pesant typiquement environ 7.5 MB, 27 MB et 100 MB en 2K, 4K et 8K. Nos images 2K en 16:9 de la même session faisaient 2720×1536.

Les paliers de résolution côte à côte

resolutionExemples de dimensionsPrix par imageQuand l’utiliser
2K2048×2048 (1:1), 2720×1536 (16:9, mesuré)13 crédits ($0.065)Web, réseaux sociaux, brouillons
4K5440×3072 (16:9)19 crédits ($0.095)Grands écrans, recadrages modérés
8K8192×8192 (1:1), 10880×6144 (16:9, mesuré)32 crédits ($0.16)Impression, panneaux d’affichage, recadrages serrés à partir d’une seule image

Les références ajoutent 1 crédit chacune, une fois par requête.

Gérer les fichiers 8K dans votre pipeline

Un PNG 8K est trop lourd pour être traité comme une miniature. Changements pratiques :

  • Utilisez callback_url. Une requête qui dure plusieurs minutes ne doit pas garder une requête web ouverte. PoYo envoie le résultat de la tâche en POST à votre URL lorsqu’elle se termine ou échoue.
  • Écrivez le téléchargement en streaming sur disque ou dans un stockage objet. Ne chargez pas un corps de 128 MB en mémoire dans une fonction serverless à faible limite mémoire, et augmentez le délai de lecture du client HTTP.
  • Supprimez le canal alpha si vous n’en avez pas besoin. Nos fichiers téléchargés étaient en RGBA, même pour des images opaques. La conversion en RGB, ou en JPEG ou WebP pour la diffusion, est une étape à ajouter vous-même ; l’API n’a pas de champ de format de sortie.
  • Gardez le master 8K, servez des dérivés. Générez une fois en 8K, puis redimensionnez pour le web. Une seconde génération 8K du même prompt est une nouvelle image et une nouvelle facturation.
  • Budgétez les séries avec soin. n multiplie le prix par image : une série de 10 images en 8K représente 320 crédits ($1.60). La documentation PoYo estime une série de 10 images en 8K à environ 30 minutes : c’est un cas d’usage pour les webhooks.

Agrandir une image existante en 8K

Passez l’image dans image_urls, réglez resolution sur 8K et dites ce qui ne doit pas changer :

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "Recreate @Image1 at full detail. Keep the composition, subject, colors and lighting of @Image1 unchanged.",
    "image_urls": ["https://example.com/product-hero.png"],
    "resolution": "8K"
  }
}

Il s’agit d’une nouvelle génération guidée par la référence, pas d’un upscaler au pixel près : décrivez donc tout ce qui doit rester exactement identique. Coût : 32 + 1 = 33 crédits ($0.165).

Pages longues avec kling-4.0-long-image

Kling décrit la génération au format long pour les pages produit e-commerce et le web design, avec une mise en page complète livrée en une seule image. Sur PoYo, c’est un identifiant de modèle séparé avec un champ skill. La sortie est un PNG unique, de 1024 px de large en 1K ou 2048 px en 2K, dont la hauteur dépend du contenu.

Designs de pages web

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "A landing page for a specialty coffee roastery: hero with coffee beans, story section, three featured blends with prices, brewing guide, customer reviews and footer. Warm earthy palette. All text on the page is in English.",
    "skill": "webpage",
    "resolution": "1K"
  }
}

Entrées facultatives pour webpage :

ChampBalise de promptEffet
style_image_url@StyleImageLe design suit son style visuel et sa mise en page
subject_image_url@SubjectImageLe design est construit autour du sujet qu’elle montre

Ce que nous avons mesuré : une requête webpage en 1K a renvoyé une page de 1024×4257, à 110 crédits ($0.55), en environ 1.7 à 2.2 minutes (API de production PoYo, 19 novembre 2026).

Précisez la langue du texte de la page

C’est la seule chose à ajouter à chaque prompt long-image. Lors de notre test, la première requête de page web utilisait un prompt en anglais qui ne disait pas dans quelle langue rédiger le texte de la page, et la page est revenue avec du texte en chinois. Ajouter la phrase « All text on the page is in English. » au prompt a réglé le problème à l’exécution suivante. Comme chaque relance est facturée au prix plein (110 crédits pour une page web 1K), intégrez dès le départ la consigne de langue dans votre modèle de prompt, quelle que soit la langue dont votre page a besoin. Kling cite l’anglais, le chinois simplifié et traditionnel, le japonais, le coréen, l’espagnol et le portugais pour le rendu du texte.

Pages produit e-commerce

skill: "ecommerce" construit une page produit à partir de 1 à 3 photos produit, désignées par @Image1 à @Image3 :

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "Design a product detail page for the insulated water bottle in @Image1: hero shot, key features, capacity and size, materials, and lifestyle scenes. All text on the page is in English.",
    "skill": "ecommerce",
    "image_urls": ["https://example.com/water-bottle.png"],
    "length": "medium",
    "resolution": "1K"
  }
}

length fixe le nombre de sections de la page, ainsi que le prix :

lengthSections (approx.)1K2K
short2–547 crédits ($0.235)57 crédits ($0.285)
medium (par défaut)6–1094 crédits ($0.47)110 crédits ($0.55)
long11–18157 crédits ($0.785)173 crédits ($0.865)

Chaque photo produit ajoute 1 crédit. Pour donner une idée de la hauteur de ces pages, la documentation PoYo cite l’exemple d’une page long en 2K : jusqu’à 2048×54,941 px, environ 87 MB.

Afficher et découper les images longues

Une page de 1024 px de large et de plusieurs milliers de pixels de haut ne tient pas dans un aperçu d’image classique. Découpez-la en sections ou en tuiles de la hauteur d’un écran pour la relecture, et conservez l’original pour le téléchargement. Considérez le résultat comme une maquette : le texte, les prix et les boutons sont des pixels, pas du HTML.

Liste de contrôle des prompts pour le 8K et les pages longues

  • Indiquez la langue de tout texte présent dans l’image.
  • Pour les pages, listez les sections dans l’ordre : hero, fonctionnalités, caractéristiques, avis, footer.
  • Mettez le texte exact entre guillemets et dites où il va ; Kling indique que le modèle affiche jusqu’à 2,000 caractères par image.
  • Pour le 8K, décrivez les textures et les détails fins qui doivent survivre à un recadrage.
  • Pour les références, donnez un rôle à chaque balise : « @Image1 is the product, keep its shape and label ».

Référence complète des requêtes et code de polling : guide de la Kling Image 4.0 API. Coûts : prix de la Kling Image 4.0 API. Contexte sur les deux identifiants de modèle : Qu’est-ce que Kling Image 4.0.

Questions fréquentes

La Kling Image 4.0 API produit-elle vraiment du 8K ? Oui. Avec resolution: "8K", notre test en 16:9 a renvoyé un PNG 10880×6144, et la documentation PoYo indique 8192×8192 en 1:1. Kling présente cela comme une génération 8K native.

Combien de temps prend une requête 8K à la Kling Image 4.0 API ? Environ 3.8 minutes pour une image 8K en 16:9 lors de notre test du jour du lancement. Les séries plus grandes prennent beaucoup plus de temps : utilisez callback_url.

Combien coûte une image 8K avec la Kling Image 4.0 API ? 32 crédits ($0.16) par image sur PoYo, plus 1 crédit par référence.

Quelles tailles renvoie l’API long image de Kling Image 4.0 ? 1024 px de large en 1K ou 2048 px en 2K ; la hauteur suit le contenu. Notre page web 1K faisait 1024×4257.

Pourquoi le texte de ma page longue Kling Image 4.0 est-il dans la mauvaise langue ? Le prompt n’en précisait aucune. Ajoutez une ligne comme « All text on the page is in English. »

Share: