Skip to main content
POST
cURL
Use este endpoint para crear una tarea asíncrona de Kling Omni Image mediante CometAPI. La solicitud de creación devuelve un task_id; utilice la operación Obtener una tarea de imagen de Kling Omni para consultar la tarea hasta que las URL de las imágenes generadas estén disponibles.
Para consultar la referencia completa de parámetros del proveedor, consulte la documentación de Kling Image O1.

Elija la estructura de la solicitud

  • Generación de una sola imagen: envíe prompt, image_list, resolution, result_type: single, n y aspect_ratio
  • Salida con marca de agua: agregue watermark_info.enabled: true cuando necesite una URL de resultado con marca de agua en la respuesta de consulta
  • ID de modelo: omita model_name para usar el valor predeterminado de la ruta, o envíe un ID de modelo Omni Image probado, como kling-image-o1 o kling-v3-omni
Las imágenes de referencia usan elementos image_list con un campo image. El Prompt puede citarlas por índice, como <<<image_1>>> para el primer elemento y <<<image_2>>> para el segundo elemento.

Flujo de tareas

1

Crear la tarea

Envíe POST /kling/v1/images/omni-image y almacene el valor data.task_id devuelto.
2

Consultar la tarea

Sondee GET /kling/v1/images/omni-image/ hasta que data.task_status sea succeed o failed.
3

Almacenar las imágenes

Cuando la tarea se complete correctamente, copie data.task_result.images[].url en su propio almacenamiento si necesita acceso duradero.
Para consultar el esquema de respuesta completo y los detalles del estado de la tarea, consulte Obtener una tarea de imagen de Kling Omni. La siguiente solicitud consulta una tarea una vez:

Campos de resultado

Las respuestas de consulta correctas devuelven imágenes generadas en data.task_result.images. Cada elemento puede incluir: Las URL de los recursos generados pueden caducar o ser eliminadas por el servicio del proveedor. Almacene las imágenes terminadas en su propia capa de almacenamiento cuando su flujo de trabajo requiera una retención prolongada.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI API key.

Encabezados

Content-Type
string

Must be application/json.

Cuerpo

application/json
prompt
string
requerido

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>
predeterminado:1k

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

Opciones disponibles:
1k,
2k,
4k
result_type
enum<string>
predeterminado:single

Use single for a single-image task.

Opciones disponibles:
single
n
integer
predeterminado:1

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

Rango requerido: 1 <= x <= 9
aspect_ratio
enum<string>
predeterminado:auto

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

Opciones 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.

Respuesta

200 - application/json

Task accepted.

code
integer
requerido

Response code. 0 means the task request was accepted.

message
string
requerido

Response message.

data
object
requerido
request_id
string

Request identifier returned by CometAPI when present.

Última modificación el 31 de julio de 2026