
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ésultat | Valeur |
|---|---|
| Sortie | PNG 10880×6144 |
| Taille du fichier | environ 128 MB |
| Coût | 32 crédits ($0.16) |
| De la soumission au résultat | environ 3.8 minutes |
| Format de pixel | RGBA (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
resolution | Exemples de dimensions | Prix par image | Quand l’utiliser |
|---|---|---|---|
2K | 2048×2048 (1:1), 2720×1536 (16:9, mesuré) | 13 crédits ($0.065) | Web, réseaux sociaux, brouillons |
4K | 5440×3072 (16:9) | 19 crédits ($0.095) | Grands écrans, recadrages modérés |
8K | 8192×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.
nmultiplie 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 :
| Champ | Balise de prompt | Effet |
|---|---|---|
style_image_url | @StyleImage | Le design suit son style visuel et sa mise en page |
subject_image_url | @SubjectImage | Le 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 :
length | Sections (approx.) | 1K | 2K |
|---|---|---|---|
short | 2–5 | 47 crédits ($0.235) | 57 crédits ($0.285) |
medium (par défaut) | 6–10 | 94 crédits ($0.47) | 110 crédits ($0.55) |
long | 11–18 | 157 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 : «
@Image1is 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. »