Criar uma tarefa de imagem Kling Omni
Use o CometAPI POST /kling/v1/images/omni-image para criar tarefas de Kling Omni Image com entradas de prompt e imagem de referência.
task_id; use Obter uma tarefa de imagem Kling Omni para consultar a tarefa até que as URLs da imagem gerada estejam disponíveis.
Escolha o formato da solicitação
- Geração de uma única imagem: envie
prompt,image_list,resolution,result_type: single,neaspect_ratio - Saída com marca d’água: adicione
watermark_info.enabled: truequando precisar de uma URL de resultado com marca d’água na resposta da consulta - Model ID: omita
model_namepara usar o padrão da rota ou envie um model ID Omni Image testado, comokling-image-o1oukling-v3-omni
image_list com um campo image. O prompt pode referenciá-las por índice, como <<<image_1>>> para o primeiro item e <<<image_2>>> para o segundo item.
Fluxo da tarefa
Criar a tarefa
POST /kling/v1/images/omni-image e armazene o data.task_id retornado.Consultar a tarefa
data.task_status seja succeed ou failed.Persistir as imagens
data.task_result.images[].url para o seu próprio armazenamento se precisar de acesso durável.Campos do resultado
Respostas de consulta bem-sucedidas retornam imagens geradas emdata.task_result.images. Cada item pode incluir:
Autorizações
Bearer token authentication. Use your CometAPI API key.
Cabeçalhos
Must be application/json.
Corpo
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.
Optional model ID for this Omni Image request. Omit this field to use the route default.
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.
Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.
1k, 2k, 4k Use single for a single-image task.
single Number of single-image results to generate. Range: 1 to 9.
1 <= x <= 9Requested output aspect ratio in width:height format. Use auto to let the provider choose from the prompt and references.
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.
Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.
User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.