Skip to main content
POST
cURL
Use este endpoint para criar uma tarefa assíncrona Kling Omni Image por meio do CometAPI. A solicitação de criação retorna um task_id; use Obter uma tarefa de imagem Kling Omni para consultar a tarefa até que as URLs das imagens geradas estejam disponíveis.
Para a referência completa dos parâmetros do provedor, consulte a documentação do Kling Image O1.

Escolha o formato da solicitação

  • Geração de imagem única: envie prompt, image_list, resolution, result_type: single, n e aspect_ratio
  • Saída com marca d’água: adicione watermark_info.enabled: true quando precisar de uma URL de resultado com marca d’água na resposta da consulta
  • ID do modelo: omita model_name para usar o padrão da rota ou envie um ID de modelo Omni Image testado, como kling-image-o1 ou kling-v3-omni
As imagens de referência usam itens image_list com um campo image. O Prompt pode referenciá-las pelo índice, como <<<image_1>>> para o primeiro item e <<<image_2>>> para o segundo item.

Fluxo da tarefa

1

Criar a tarefa

Envie POST /kling/v1/images/omni-image e armazene o data.task_id retornado.
2

Consultar a tarefa

Faça polling com GET /kling/v1/images/omni-image/ até que data.task_status seja succeed ou failed.
3

Armazenar as imagens

Quando a tarefa for bem-sucedida, copie data.task_result.images[].url para seu próprio armazenamento se precisar de acesso duradouro.
Para o esquema de resposta completo e os detalhes de status da tarefa, consulte Obter uma tarefa de imagem Kling Omni. A solicitação a seguir consulta uma tarefa uma vez:

Campos de resultado

Respostas de consulta bem-sucedidas retornam imagens geradas em data.task_result.images. Cada item pode incluir: As URLs dos ativos gerados podem expirar ou ser removidas pelo serviço do provedor. Armazene as imagens concluídas em sua própria camada de armazenamento quando seu fluxo de trabalho exigir retenção prolongada.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI API key.

Cabeçalhos

Content-Type
string

Must be application/json.

Corpo

application/json
prompt
string
obrigatório

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>
padrão:1k

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

Opções disponíveis:
1k,
2k,
4k
result_type
enum<string>
padrão:single

Use single for a single-image task.

Opções disponíveis:
single
n
integer
padrão:1

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

Intervalo necessário: 1 <= x <= 9
aspect_ratio
enum<string>
padrão:auto

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

Opções disponíveis:
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.

Resposta

200 - application/json

Task accepted.

code
integer
obrigatório

Response code. 0 means the task request was accepted.

message
string
obrigatório

Response message.

data
object
obrigatório
request_id
string

Request identifier returned by CometAPI when present.

Última modificação em 31 de julho de 2026