
La Kling Image 4.0 API (kling-4.0-image) succède à la Kling O3 Image API (kling-o3-image et kling-o3-image-edit) sur PoYo. En bref : Kling Image 4.0 ajoute le 8K, les séries d’images, un prompt de 50,000 caractères et un modèle séparé pour les pages longues, et coûte environ trois à quatre fois plus cher par image. Cet article compare les deux requête par requête pour vous aider à décider quels appels migrer. Les deux sont disponibles sur PoYo : Kling Image 4.0 et Kling O3 Image.
La décision en un tableau
| Si votre requête a besoin de… | Appelez |
|---|---|
| Une sortie 1K, ou le prix par image le plus bas | kling-o3-image / kling-o3-image-edit |
| Du JPEG ou du WebP directement depuis l’API | Kling O3 Image (output_format) |
| Plus que du 4K, ou exactement du 8K | kling-4.0-image |
| Une série de 2–10 images avec le même sujet et le même style | kling-4.0-image avec enable_sequential |
| Des prompts de plus de 2,000 caractères | kling-4.0-image (jusqu’à 50,000) |
| Une page web complète ou une page produit e-commerce en une seule image | kling-4.0-long-image |
| Le texte vers image et l’édition sur un seul identifiant de modèle | kling-4.0-image |
Différences de requête champ par champ
Les deux utilisent POST https://api.poyo.ai/api/generate/submit, le même endpoint de statut et le même callback_url. Les différences se trouvent dans model et input, d’après la documentation PoYo de chaque modèle.
| Champ | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
model | kling-o3-image (texte vers image), kling-o3-image-edit (édition) | kling-4.0-image pour les deux ; image_urls active le mode édition |
prompt | jusqu’à 2,000 caractères | 1–50,000 caractères |
image_urls | 1–10, obligatoire pour kling-o3-image-edit | 1–10 (facultatif) ; 30 MB, ≥300 px, ratio 0.4–2.5 chacune |
| Elements | elements: [{frontal_image_url, reference_image_urls}] | kling_elements: [{element_input_urls: [front, …]}], 2–4 vues, jusqu’à 7, images + elements ≤ 10 |
resolution | 1K (par défaut), 2K, 4K | 2K (par défaut), 4K, 8K |
size | 8 formats, 16:9 par défaut ; auto uniquement sur le modèle d’édition | les mêmes 8 formats plus auto, auto par défaut |
output_format | jpeg, png (par défaut), webp | non accepté ; PNG uniquement |
n | 1–9 | 1–9 indépendantes, ou 2–10 avec enable_sequential: true |
enable_sequential | non disponible | true renvoie une série ordonnée et cohérente |
| Pages longues | non disponible | modèle séparé kling-4.0-long-image |
Dans son article de lancement, Kling présente Kling Image 4.0 comme son premier modèle à génération 8K native, capable de planifier jusqu’à 10 images à partir d’un seul prompt et d’afficher jusqu’à 2,000 caractères de texte en sept langues. Ce sont les affirmations de Kling ; les différences d’API ci-dessus sont ce qui change dans votre code.
Prix pour la même requête
Prix PoYo, 1 crédit = $0.005. Kling O3 Image n’a pas de supplément par référence sur PoYo ; la Kling Image 4.0 API ajoute 1 crédit par image de référence ou element, une fois par requête. La page de tarifs de Kling mentionne le même changement : Kling Image 4.0 facture les entrées de référence, les modèles précédents non.
| Même requête | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
| 1 image, 1K | 3.5 crédits ($0.0175) | non proposé (2K minimum : 13 crédits) |
| 1 image, 2K | 3.5 crédits ($0.0175) | 13 crédits ($0.065) |
| 1 image, 4K | 7 crédits ($0.035) | 19 crédits ($0.095) |
| 1 image, 8K | non proposé | 32 crédits ($0.16) |
| Édition 2K, 2 images de référence + 1 element | 3.5 crédits ($0.0175) | 16 crédits ($0.08) |
| 4 images en 2K | 14 crédits ($0.07), indépendantes | 52 crédits ($0.26), en série ou indépendantes |
| Design de page web, 1K | non proposé | 110 crédits ($0.55) |
En 2K, la Kling Image 4.0 API coûte environ 3.7× le prix de Kling O3 Image par image, et environ 2.7× en 4K. Les tableaux complets de Kling Image 4.0 se trouvent dans Prix de la Kling Image 4.0 API.
Les limites qui changent
- Le plancher de résolution monte. Le 1K disparaît ; la plus petite sortie de Kling Image 4.0 est en 2K. Si vous servez des miniatures, gardez-les sur O3 ou redimensionnez de votre côté.
- Le plafond passe à 8K. La documentation PoYo indique 8192×8192 en 1:1. Lors de notre test du jour du lancement (API de production PoYo, 19 novembre 2026), une requête 8K en 16:9 a renvoyé un PNG 10880×6144 d’environ 128 MB en environ 3.8 minutes, pour 32 crédits.
- Gestion des fichiers. Pas de
output_format: vous recevez du PNG. Nos fichiers téléchargés étaient des PNG RGBA, même pour des images opaques. Prévoyez la conversion et le stockage si vous utilisiezjpegouwebpsur O3. - Les règles sur les références sont explicites. Kling Image 4.0 valide chaque référence : jusqu’à 30 MB, au moins 300 px par côté, rapport largeur/hauteur entre 0.4 et 2.5. La documentation O3 n’indique pas de telles limites : validez donc les images très larges ou petites avant de migrer.
- Les séries prennent plus de temps. Notre série de quatre images 2K a pris environ 4.9 minutes. Passez les travaux longs ou volumineux sur
callback_url.
Quand migrer
Passez un appel sur kling-4.0-image lorsqu’il a besoin de quelque chose qu’O3 ne sait pas faire : 8K, série cohérente, prompt long ou design de page. Par exemple :
- Storyboards et angles produit. Sur O3, vous envoyez
n: 4en espérant que le sujet corresponde. Avecenable_sequential: true, le modèle planifie la série ; notre test a conservé le même pilote, la même moto et la même tenue à l’aube, à midi, au coucher du soleil et la nuit. - Visuels pour l’impression et avec beaucoup de recadrage. Tout ce qui dépasse le 4K.
- Prompts longs et structurés. Chartes de marque, listes de plans et blocs de texte au-delà de 2,000 caractères.
- Pages e-commerce.
kling-4.0-long-imageconstruit toute la page produit ; O3 n’a pas d’équivalent.
Gardez O3 pour les brouillons 1K–2K à gros volume, les miniatures et les pipelines qui ont besoin de JPEG ou WebP directement depuis l’API. Utiliser les deux ne pose aucun problème : O3 pour explorer, Kling Image 4.0 pour la série finale, avec la même clé.
Diff de migration
Un appel texte vers image :
{
- "model": "kling-o3-image",
+ "model": "kling-4.0-image",
"input": {
"prompt": "A cinematic futuristic alley with rain and neon reflections",
"resolution": "4K",
"size": "16:9",
- "output_format": "png",
"n": 2
}
}
Une édition avec un element. Deux champs renommés, une fusion d’identifiants de modèle :
{
- "model": "kling-o3-image-edit",
+ "model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
- "elements": [
- {
- "frontal_image_url": "https://example.com/character-front.png",
- "reference_image_urls": ["https://example.com/character-side.png"]
- }
- ],
+ "kling_elements": [
+ {
+ "element_input_urls": [
+ "https://example.com/character-front.png",
+ "https://example.com/character-side.png"
+ ]
+ }
+ ],
- "resolution": "1K",
- "size": "auto",
- "output_format": "png"
+ "resolution": "2K",
+ "size": "auto"
}
}
Liste de contrôle :
- Remplacez les deux identifiants de modèle O3 par
kling-4.0-image; le mode édition découle désormais deimage_urls. - Renommez
elementsenkling_elementset fusionnezfrontal_image_urletreference_image_urlsdans un seul tableauelement_input_urls, vue de face en premier, 2–4 URL au total. Un element O3 à une seule vue a besoin d’au moins une vue supplémentaire. - Supprimez
output_format. Le schéma rejette les champs inconnus. - Passez de
1Kà2K; définissezsizeexplicitement si vous comptiez sur le16:9par défaut d’O3, car la nouvelle valeur par défaut estauto. - Ajoutez le supplément par référence à vos estimations de coût.
- Augmentez les délais d’attente du client ou passez aux webhooks pour le 8K et les séries.
Le polling du statut, la lecture de files[].file_url et la vérification des webhooks restent identiques. La référence complète des requêtes se trouve dans le guide de la Kling Image 4.0 API.
Et Kling O1 Image ?
Kling O1 Image ne fait que de l’édition (kling-o1-image-edit), en 1K ou 2K, pour 3.5 crédits par image. Traitez-le comme kling-o3-image-edit dans le tableau ci-dessus : une édition par référence peu coûteuse, sans 4K ni 8K, sans séries.
Questions fréquentes
La Kling Image 4.0 API remplace-t-elle directement la Kling O3 Image API ?
Presque. L’endpoint, l’authentification, le polling et les webhooks sont identiques. Vous changez l’identifiant de modèle, renommez elements en kling_elements, supprimez output_format et passez les requêtes 1K en 2K.
Lequel est le moins cher, la Kling Image 4.0 API ou Kling O3 Image ? Kling O3 Image : 3.5 crédits par image en 1K ou 2K et 7 en 4K, contre 13, 19 et 32 crédits en 2K, 4K et 8K pour Kling Image 4.0, qui ajoute en plus 1 crédit par référence.
Kling O3 Image prend-il en charge le 8K ou les séries d’images ?
Non. Sur PoYo, Kling O3 Image plafonne à 4K et renvoie 1–9 images indépendantes. Le 8K et les séries enable_sequential sont des fonctionnalités de la Kling Image 4.0 API.
Puis-je encore obtenir du JPEG avec la Kling Image 4.0 API ? Pas depuis l’API : la sortie est en PNG. Convertissez après le téléchargement, ou gardez les travaux JPEG et WebP sur Kling O3 Image.
Ai-je besoin d’une nouvelle clé API pour la Kling Image 4.0 API ?
Non. La même clé PoYo fonctionne pour kling-4.0-image, kling-4.0-long-image, kling-o3-image et tous les autres modèles.