> ## 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.
# Obter uma tarefa de imagem Kling Omni
> Use o CometAPI GET /kling/v1/images/omni-image/{task_id} para consultar o status da tarefa Kling Omni Image e recuperar as URLs das imagens geradas.
Use este endpoint depois de [criar uma tarefa de imagem Kling Omni](/api/image/kling/omni-image). Passe o `data.task_id` retornado pela requisição de criação e consulte até que `data.task_status` seja `succeed` ou `failed`.
A rota pública de consulta do CometAPI é `GET /kling/v1/images/omni-image/{task_id}`. Não use `GET /v1/images/omni-image`; essa rota não é um endpoint público de consulta do CometAPI para tarefas Kling Omni Image.
## Comportamento da consulta
* Use a mesma conta CometAPI que criou a tarefa
* Consulte a cada 20-30 segundos até que `task_status` seja `succeed` ou `failed`
* Leia as URLs das imagens geradas em `data.task_result.images` quando a tarefa for concluída com sucesso
* Armazene as imagens concluídas no seu próprio armazenamento se precisar de acesso durável
Tarefas de outra conta, registros expirados ou IDs desconhecidos retornam `task_not_exist`.
## Campos do resultado
Respostas de consulta bem-sucedidas retornam imagens geradas em `data.task_result.images`. Cada item pode incluir:
| Field | Description |
| --------------- | ---------------------------------------------------------------------------- |
| `index` | Posição da imagem gerada no resultado da tarefa. |
| `url` | URL da imagem gerada. |
| `watermark_url` | URL da imagem com marca d'água quando a saída com marca d'água é solicitada. |
As URLs dos recursos gerados podem expirar ou ser removidas pelo serviço do provedor. Armazene as imagens concluídas na sua própria camada de armazenamento quando seu fluxo de trabalho exigir retenção prolongada.
## 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.
````