Skip to main content
POST
cURL
Utilisez ce endpoint pour créer une tâche Kling Omni Image asynchrone via CometAPI. La requête de création renvoie un task_id ; utilisez Obtenir une tâche d’image Kling Omni pour interroger la tâche jusqu’à ce que les URL des images générées soient disponibles.
Pour la référence complète des paramètres du fournisseur, consultez la documentation Kling Image O1.

Choisir la forme de la requête

  • Génération d’une seule image : envoyez prompt, image_list, resolution, result_type: single, n et aspect_ratio
  • Sortie avec filigrane : ajoutez watermark_info.enabled: true lorsque vous avez besoin d’une URL de résultat avec filigrane dans la réponse de requête
  • model ID : omettez model_name pour utiliser la valeur par défaut de la route, ou envoyez un model ID Omni Image testé tel que kling-image-o1 ou kling-v3-omni
Les images de référence utilisent des éléments image_list avec un champ image. Le prompt peut les citer par index, par exemple <<<image_1>>> pour le premier élément et <<<image_2>>> pour le second.

Flux de la tâche

1

Créer la tâche

Soumettez POST /kling/v1/images/omni-image et stockez le data.task_id renvoyé.
2

Interroger la tâche

Interrogez GET /kling/v1/images/omni-image/ jusqu’à ce que data.task_status soit succeed ou failed.
3

Conserver les images

Lorsque la tâche réussit, copiez data.task_result.images[].url dans votre propre stockage si vous avez besoin d’un accès durable.
Pour le schéma de réponse complet et des exemples d’interrogation, consultez Obtenir une tâche d’image Kling Omni. L’exemple court suivant interroge une tâche jusqu’à ce qu’elle atteigne un état terminal :

Champs de résultat

Les réponses de requête réussies renvoient les images générées dans data.task_result.images. Chaque élément peut inclure : Les URL des ressources générées peuvent expirer ou être supprimées par le service du fournisseur. Stockez les images finales dans votre propre couche de stockage lorsque votre flux de travail nécessite une conservation prolongée.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI API key.

En-têtes

Content-Type
string

Must be application/json.

Corps

application/json
prompt
string
requis

Text prompt for the generated image. The prompt can reference images with <<<image_1>>>, <<<image_2>>>, and matching indexes from image_list. Maximum length is 2,500 characters.

model_name
string

Optional model ID for this Omni Image request. Omit this field to use the route default.

image_list
object[]

Reference images that the prompt can cite with <<<image_1>>>, <<<image_2>>>, and so on. Keep the total number of reference images within the provider limits for the selected model.

resolution
enum<string>
défaut:1k

Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.

Options disponibles:
1k,
2k,
4k
result_type
enum<string>
défaut:single

Use single for a single-image task.

Options disponibles:
single
n
integer
défaut:1

Number of single-image results to generate. Range: 1 to 9.

Plage requise: 1 <= x <= 9
aspect_ratio
enum<string>
défaut:auto

Requested output aspect ratio in width:height format. Use auto to let the provider choose from the prompt and references.

Options disponibles:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9,
auto
watermark_info
object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.

callback_url
string<uri>

Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.

external_task_id
string

User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.

Réponse

200 - application/json

Task accepted.

code
integer
requis

Response code. 0 means the task request was accepted.

message
string
requis

Response message.

data
object
requis
request_id
string

Request identifier returned by CometAPI when present.