Passer au contenu principal
POST
Envoyez une requête asynchrone à POST /v1/images/generations avec model: "kling-v4-image". Récupérez data[0].task_id, puis consultez le résultat avec GET /v1/tasks/{task_id}.

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-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 pour la génération depuis du texte, des images et pour les séries. Décrivez les éléments souhaités et ceux à éviter. La limite est de 50 000 caractères pour un texte uniquement en anglais et de 21 000 pour un texte uniquement en chinois ou dans des langues similaires ; les textes multilingues sont calculés proportionnellement.
string[]
Jusqu’à 10 images de référence, sous forme d’URL directes accessibles publiquement. Pour un fichier local, utilisez l’API d’envoi d’images, puis transmettez l’url renvoyée.Formats JPG / JPEG / PNG / GIF. Chaque image doit faire au plus 30 MB, au moins 300 px en largeur et en hauteur, avec un rapport entre 2:5 et 5:2.Les références sont vérifiées à l’envoi. Une URL renvoyant HTTP 403 / 404 / 410, un côté inférieur à 300 px, un rapport hors de 2:5–5:2 ou une image de plus de 30 MB provoque immédiatement HTTP 400, sans création de tâche ni frais de génération. Les autres échecs de récupération, comme un délai d’attente du serveur d’origine, sont d’abord acceptés ; la tâche échoue ensuite et les frais de génération prélevés à l’avance sont intégralement remboursés.Utilisez @Image1, @Image2, etc. dans le prompt pour désigner les images dans l’ordre du tableau. Elles servent aussi de référence sans ces marqueurs.
integer
défaut:"1"
Nombre d’images en mode standard : entier de 1 à 9, par défaut 1. En mode série, n peut être omis ou égal à 1 ; le nombre de sorties est défini par sequential_image_generation_options.max_images. n > 1 en mode série renvoie HTTP 400.
string
défaut:"2K"
Accepte 2K (par défaut), 4K et 8K, sans distinction de casse. La sortie est en PNG. Au format 1:1, 2K correspond à 2048×2048, 4K à 4096×4096 et 8K à 8192×8192. Pour les autres rapports, consultez les dimensions réelles des images renvoyées.Le mode 8K prend aussi en charge la génération depuis du texte, depuis des images et en série : 1–9 sorties en mode standard, 2–4 en série et jusqu’à 10 images de référence. Les formats, dimensions et la limite de 30 MB par image de référence restent identiques.
string
défaut:"auto"
Rapport largeur/hauteur de sortie. Accepte auto (par défaut) et ces 8 rapports explicites :16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.auto choisit le rapport selon le prompt ou les images de référence. Les dimensions en pixels, comme 2048x2048, ne sont pas acceptées.
string
Alias de size, avec les mêmes valeurs. Si les deux sont fournis, aspect_ratio est prioritaire.
string
défaut:"disabled"
disabled ou l’absence du champ active la génération standard. auto génère une série d’images liées et rend sequential_image_generation_options.max_images obligatoire. Ici, auto ne choisit pas automatiquement le nombre d’images.
object
Définit le nombre d’images en mode série.
width, height, mask_url, size en pixels et watermark: true ne sont pas acceptés et renvoient HTTP 400.

Exemples de requêtes

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

Génération à partir d’une image

Générer trois images 4K

Générer une image 8K

Générer une série de quatre images 8K liées

Définissez max_images entre 2 et 4. En série, n peut être omis ou égal à 1, mais pas supérieur à 1. Une série peut prendre plusieurs minutes : conservez le task_id et interrogez son état plutôt que de renvoyer la requête.

Exemples de sorties 8K et de durées

Les mesures suivantes proviennent de l’environnement de test. Dimensions, tailles de fichiers et durées sont indicatives ; les résultats réels peuvent varier. Consultez le statut toutes les 5–10 secondes jusqu’à completed ou failed. estimated_time est fixé à 60 secondes et ne doit pas servir d’estimation réelle ni de compte à rebours. Conservez le task_id et évitez de soumettre à nouveau la requête pendant l’attente. Les résultats 8K sont des PNG originaux ; un seul fichier peut dépasser 100 MB. Pour les listes et aperçus, utilisez des miniatures que vous générez ou un chargement à la demande. Proposez le téléchargement de l’original et indiquez la taille importante du fichier.

Consulter la tâche

Lisez data.status via l’API de suivi des tâches : pending / processing indique un traitement en cours, completed un succès et failed un échec détaillé dans data.error.message.
Voici la structure d’un résultat réussi. Les URL sont dans data.result.images[].url[] ; url est un tableau. Parcourez toutes les sorties et téléchargez-les rapidement.

Facturation

La facturation dépend du nombre réel d’images générées et de la résolution choisie. Les références sont facturées séparément par image. Consultez la page des tarifs.
  • En génération standard, n=3 correspond à 3 sorties facturées ; pour les séries, le nombre réellement renvoyé est utilisé.
  • Chaque référence est comptée une fois par requête, sans multiplication par le nombre de sorties. Générer 3 images à partir de 2 références correspond à 2 entrées et 3 sorties facturées.
  • Les tâches de génération échouées ne sont pas facturées ; les frais de génération prélevés à l’avance sont intégralement remboursés.

Erreurs courantes de paramètres

Ces erreurs renvoient HTTP 400 de façon synchrone à l’envoi, sans création de tâche ni frais de génération. Lisez error.message pour les erreurs d’envoi et data.error.message pour les échecs après création de la tâche.