Générer des images avec Kling
Générez des images avec Kling via CometAPI : POST /kling/v1/images/generations prend en charge la création d’images à partir de prompts et la génération à partir d’images de référence.
Génération d’images
Première requête
Commencez avecmodel_name: kling-v3, prompt, n et aspect_ratio. Ajoutez des images de référence, des contrôles de fidélité ou des champs avancés seulement après que la première requête a renvoyé une tâche exploitable. Omettre model_name utilise une valeur par défaut de compatibilité héritée ; envoyez donc explicitement kling-v3 pour les nouvelles intégrations.
Lire la réponse
Enregistrez letask_id renvoyé, puis interrogez la route de requête d’image Kling correspondante jusqu’à ce que task_status atteigne un état terminal. Si votre flux de travail nécessite un stockage durable, copiez l’asset final dans votre propre couche de stockage une fois la génération terminée.Autorisations
Bearer token authentication. Use your CometAPI key.
En-têtes
Must be application/json.
Corps
Text prompt describing the image to generate. Maximum 2500 characters.
Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.
kling-v1, kling-v1-5, kling-v2, kling-v2-1, kling-v3 Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.
Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.
Reference mode for legacy image-to-image requests when image is provided.
subject, face How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.
0 <= x <= 1Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.
0 <= x <= 1Optional Kling element references. The total count of element references and input images must not exceed 10.
Output resolution. Defaults to 1k.
1k, 2k Number of images to generate. Range: 1-9.
1 <= x <= 9Output aspect ratio (width:height).
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 Watermark options.
Webhook URL to receive task status updates when the task completes.
Optional user-defined task ID for your own tracking. Must be unique per account.