Passer au contenu principal
POST
Envoyez une requête asynchrone à POST /v1/images/generations avec model: "kling-v4-long-image". Récupérez data[0].task_id, puis consultez GET /v1/tasks/{task_id}. Chaque requête renvoie un PNG vertical ; le mode web produit une image de la maquette.

Choisir un mode

Authentification

string
requis
Utilisez Authorization: Bearer <token>, où <token> est votre clé API APIMart.

Paramètres de requête

string
requis
Doit être kling-v4-long-image.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Obligatoire et non vide, y compris après suppression des espaces. Jusqu’à 166 000 caractères en anglais seul, 71 000 en chinois ou langues similaires ; calcul proportionnel pour les textes mixtes. Décrivez la disposition, les sections, les textes, le style et le sujet.
string
requis
Obligatoire : ecommerce pour une fiche produit ou webpage pour une maquette web, sans distinction de casse. Les champs de référence diffèrent selon le mode.
string
défaut:"medium"
Uniquement pour skill: "ecommerce" : short, medium (par défaut) ou long, soit environ 2–5, 6–10 ou 11–18 sections. Le contenu et la hauteur réels dépendent du résultat. Omettez ce champ en mode web, sinon HTTP 400.
string
défaut:"1K"
Accepte 1K (par défaut) et 2K, sans distinction de casse, pour toutes les longueurs commerciales, y compris long + 2K. Largeur de sortie : 1024 ou 2048 px ; la hauteur dépend du contenu. 4K n’est pas pris en charge.
string[]
Uniquement pour le commerce : 1–3 images produit obligatoires. En mode web, omettez ce champ et utilisez image_with_roles. Fournissez des URL directes publiques. Les fichiers locaux peuvent être envoyés via l’API d’envoi d’images, puis référencés par l’url renvoyée.
object[]
Facultatif, uniquement en mode web. Au plus une image style et une image subject ; une ou les deux peuvent être omises. Omettez ce champ en mode commerce.
integer
Chaque requête génère une seule image longue. Omettez le champ ou utilisez l’entier 1 ; les autres valeurs renvoient HTTP 400.
boolean
Omettez le champ ou utilisez false ; true renvoie HTTP 400.
N’envoyez pas size, aspect_ratio, width, height, mask_url, sequential_image_generation ni sequential_image_generation_options. Même null ou une chaîne vide dans ces champs renvoie HTTP 400.

Exigences et références dans le prompt

Formats JPG / JPEG / PNG. Au plus 30 MB par image, au moins 300 px sur chaque côté, rapport entre 2:5 et 5:2. Une URL renvoyant HTTP 403 / 404 / 410, des dimensions ou un rapport invalides, ou un fichier trop volumineux provoque HTTP 400 synchrone, sans tâche ni frais de génération. Les autres échecs de récupération, comme un délai du serveur d’origine dépassé, sont d’abord acceptés ; la tâche échoue ensuite et les frais prélevés sont remboursés. Utilisez @Image1, @Image2, etc. dans le prompt. En commerce, l’ordre suit image_urls ; en web, le style précède le sujet. Si une seule image est fournie, elle correspond à @Image1.

Exemples de requêtes

Envoyez ces requêtes à POST /v1/images/generations. Remplacez les URL d’exemple par des liens directs accessibles.

Fiche produit longue en 2K

Page web avec références de style et de sujet

Page web à partir du prompt uniquement

Consulter la tâche

Interrogez l’API de suivi des tâches environ toutes les 10 secondes. Conservez le task_id et évitez de soumettre à nouveau la génération si l’attente se prolonge.
Voici la structure d’un résultat réussi. images et url sont des tableaux ; ce modèle renvoie une seule image longue par requête.
Téléchargez l’image avant l’horodatage Unix en secondes indiqué par data.result.images[0].expires_at. Le lien expire ensuite.
La génération prend généralement plusieurs minutes ; un exemple long + 2K a pris 432 secondes. estimated_time renvoie actuellement toujours 60 secondes : ne l’utilisez ni comme compte à rebours ni comme seuil d’expiration. La durée varie avec le contenu et la charge ; cet exemple n’est pas une limite.La hauteur et le poids varient selon le contenu. Un exemple long + 2K mesurait 2048×46615 et 63,9 MB ; ces valeurs ne sont pas des limites. Les résultats peuvent dépasser 50 MB : prévoyez le coût de téléchargement et d’affichage des grandes images.

Facturation

Chaque requête facture une image longue au niveau de sortie choisi, plus les références : prix du niveau de sortie + nombre de références × prix par référence. Produit, style et sujet sont tous comptés ; la première référence est payante. Les 8 niveaux sont listés ci-dessous. Clés tarifaires : kling-v4-long-image@<niveau> et kling-v4-long-image@input pour les références. Dans la requête de génération, resolution reste limité à 1K ou 2K. Les frais sont prélevés à l’envoi, finalisés en cas de succès et entièrement remboursés en cas d’échec. Consultez la page des tarifs pour les prix et remises du compte.

Erreurs courantes

Ces erreurs renvoient HTTP 400 de manière synchrone, sans tâche ni frais de génération. Les erreurs d’envoi figurent dans error.message, celles après création dans data.error.message.