Skip to main content
POST
cURL
Usa este endpoint cuando quieras que Kling genere una imagen a partir de múltiples referencias de sujeto, además de referencias opcionales de escena o estilo.

Antes de llamarlo

  • Proporciona de 1 a 4 imágenes en subject_image_list
  • Usa model_name: kling-v2-1 para nuevas solicitudes
  • Añade scene_image o style_image solo cuando la composición principal del sujeto ya funcione
  • Trata esto como una ruta de generación asíncrona y guarda el id de tarea devuelto

Flujo de la tarea

1

Enviar la tarea de generación de imagen

Envía la lista de imágenes del sujeto y el prompt, luego guarda el id de tarea devuelto.
2

Consultar la tarea

Consulta la tarea devuelta con la ruta de consulta de imágenes de Kling correspondiente hasta que la tarea alcance un estado terminal.
3

Guardar el resultado

Guarda la imagen generada en tu propio almacenamiento si necesitas acceso persistente.
Para la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Encabezados

Content-Type
string
predeterminado:application/json

Must be application/json.

Cuerpo

application/json
subject_image_list
object[]
requerido

Subject reference images. Minimum 1, maximum 4.

Required array length: 1 - 4 elements
model_name
enum<string>
predeterminado:kling-v2

Model to use for multi-image generation. Use kling-v2-1 for new requests; omitting the field uses the legacy route default.

Opciones disponibles:
kling-v2,
kling-v2-1
prompt
string

Text prompt describing the desired output. Maximum 2500 characters.

negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters.

scene_image
string

Optional scene reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

style_image
string

Optional style reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

n
integer
predeterminado:1

Number of images to generate. Range: 1-9.

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

Aspect ratio of the generated image.

Opciones disponibles:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Respuesta

200 - application/json

Task request accepted or an error response returned by the API.

code
requerido

Response code. 0 means the task request was accepted.

message
string
requerido

Response message.

data
object
requerido
request_id
string

Request identifier returned when present.