> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Obtenir une tâche d’image Kling Omni
> Utilisez CometAPI GET /kling/v1/images/omni-image/{task_id} pour interroger l’état d’une tâche Kling Omni Image et récupérer les URL des images générées.
Utilisez ce endpoint après avoir [créé une tâche d’image Kling Omni](/api/image/kling/omni-image). Transmettez le `data.task_id` renvoyé par la requête de création et interrogez l’état jusqu’à ce que `data.task_status` soit `succeed` ou `failed`.
La route de requête publique CometAPI est `GET /kling/v1/images/omni-image/{task_id}`. N’utilisez pas `GET /v1/images/omni-image` ; cette route n’est pas un endpoint de requête publique CometAPI pour les tâches Kling Omni Image.
## Comportement d’interrogation
* Utilisez le même compte CometAPI que celui qui a créé la tâche
* Interrogez l’état toutes les 20 à 30 secondes jusqu’à ce que `task_status` soit `succeed` ou `failed`
* Lisez les URL des images générées dans `data.task_result.images` lorsque la tâche réussit
* Stockez les images terminées dans votre propre espace de stockage si vous avez besoin d’un accès durable
Les tâches provenant d’un autre compte, les enregistrements expirés ou les ID inconnus renvoient `task_not_exist`.
## Champs du 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 :
| Field | Description |
| --------------- | ---------------------------------------------------------------------------- |
| `index` | Position de l’image générée dans le résultat de la tâche. |
| `url` | URL de l’image générée. |
| `watermark_url` | URL de l’image avec filigrane lorsque la sortie avec filigrane est demandée. |
Les URL des ressources générées peuvent expirer ou être supprimées par le service du fournisseur. Stockez les images terminées dans votre propre couche de stockage lorsque votre workflow nécessite une conservation à long terme.
## OpenAPI
````yaml api/openapi/image/kling/get-omni-image.openapi.json GET /kling/v1/images/omni-image/{task_id}
openapi: 3.1.0
info:
title: Kling Omni Image Query API
version: 1.0.0
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/kling/v1/images/omni-image/{task_id}:
get:
summary: Get a Kling Omni image task
description: >-
Get the status and result of a Kling Omni Image task by `task_id`. Use
the `task_id` returned by `POST /kling/v1/images/omni-image`.
operationId: get_kling_omni_image_task
parameters:
- name: task_id
in: path
required: true
description: Task ID returned by `POST /kling/v1/images/omni-image`.
schema:
type: string
responses:
'200':
description: Task status or result.
content:
application/json:
schema:
type: object
required:
- code
- message
- data
properties:
code:
type: integer
description: >-
Response code. `0` means the task was found and the status
payload was returned.
message:
type: string
description: Response message.
request_id:
type: string
description: Request identifier returned by CometAPI when present.
data:
type: object
required:
- task_id
- task_status
- created_at
- updated_at
properties:
task_id:
type: string
description: System-generated Kling task ID.
task_status:
type: string
description: Current task state.
enum:
- submitted
- processing
- succeed
- failed
task_status_msg:
type:
- string
- 'null'
description: Status detail or failure reason when returned.
task_info:
type: object
description: >-
Task metadata, including `external_task_id` when you
provided one during task creation.
properties:
external_task_id:
type:
- string
- 'null'
description: >-
User-defined task ID from the create request, when
provided.
additionalProperties: true
task_result:
type:
- object
- 'null'
description: >-
Generated output metadata. Present when the task
succeeds.
properties:
images:
type: array
description: Generated image results.
items:
type: object
properties:
index:
type: integer
description: Result image index.
url:
type: string
description: Generated image URL.
watermark_url:
type: string
description: >-
Watermarked image URL when watermark output
is requested.
additionalProperties: true
additionalProperties: true
created_at:
type: integer
description: Task creation timestamp in milliseconds.
updated_at:
type: integer
description: Task update timestamp in milliseconds.
final_unit_deduction:
type: string
description: >-
Final unit deduction after a successful task, when
returned.
additionalProperties: true
additionalProperties: true
examples:
Succeed:
summary: Finished task
value:
code: 0
message: SUCCEED
request_id:
data:
task_id:
task_info: {}
created_at: 1782450245512
updated_at: 1782450286078
task_result:
images:
- url: https://your-image-host/generated.png
index: 0
watermark_url: https://your-image-host/generated-watermarked.png
task_status: succeed
final_unit_deduction: '8'
Processing:
summary: Task still running
value:
code: 0
message: SUCCEED
request_id:
data:
task_id:
task_info: {}
created_at: 1782450245512
updated_at: 1782450245512
task_status: processing
'400':
description: Task not found for the current account or invalid request.
content:
application/json:
schema:
type: object
properties:
code:
type:
- string
- integer
- 'null'
message:
type: string
additionalProperties: true
example:
code: null
message: task_not_exist
x-codeSamples:
- lang: Shell
label: Poll task
source: >
TASK_ID=""
curl "https://api.cometapi.com/kling/v1/images/omni-image/$TASK_ID"
\
-H "Authorization: Bearer $COMETAPI_KEY"
- lang: Python
label: Poll task
source: |
import os
import time
import requests
task_id = ""
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
while True:
task = requests.get(
f"https://api.cometapi.com/kling/v1/images/omni-image/{task_id}",
headers=headers,
).json()
status = task["data"]["task_status"]
print(status)
if status in ("succeed", "failed"):
break
time.sleep(30)
if status == "succeed":
print(task["data"]["task_result"]["images"][0]["url"])
- lang: JavaScript
label: Poll task
source: >
const taskId = "";
const headers = { Authorization: `Bearer
${process.env.COMETAPI_KEY}` };
let task;
while (true) {
task = await (await fetch(
`https://api.cometapi.com/kling/v1/images/omni-image/${taskId}`,
{ headers },
)).json();
const status = task.data.task_status;
console.log(status);
if (status === "succeed" || status === "failed") break;
await new Promise((resolve) => setTimeout(resolve, 30000));
}
if (task.data.task_status === "succeed") {
console.log(task.data.task_result.images[0].url);
}
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI API key.
````