Multi-Image a Image

Usa el endpoint Kling Multi-Image to Image de CometAPI para generar nuevas imágenes a partir de múltiples entradas, con solicitudes POST simples y un Content-Type flexible.

POST /kling/v1/images/generations

Multi-Image to Image

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject_image_list": [
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    }
  ]
}
'

200

{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Usa este endpoint cuando quieras que Kling genere una imagen a partir de múltiples referencias de sujeto más referencias opcionales de escena o estilo.

​

Antes de llamarlo

• Proporciona de 2 a 4 imágenes en subject_image_list
• Usa model_name: kling-v2
• Agrega scence_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 imágenes

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

2. Consultar la tarea

   Continúa con Consultas individuales usando la ruta de consulta de imágenes de Kling 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 obtener 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

Content type of the request body.

Cuerpo

application/json

Kling Image Generation API request body definition

subject_image_list · object[] · requerido

List of subject reference images. Minimum 2, maximum 4.

Show child attributes

model_name · enum<string> · predeterminado: kling-v2

Model to use for multi-image generation.

Opciones disponibles: kling-v2

prompt · string

Text prompt describing the desired output. Max 2500 characters.

scence_image · string

Optional scene reference image. Same format and size constraints as subject images.

style_image · string

Optional style reference image. Same format and size constraints as subject images.

n · integer · predeterminado: 1

Number of images to generate.

aspect_ratio · enum<string> · predeterminado: 16:9

Aspect ratio of the generated image (width:height).

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

callback_url · string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id · string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Respuesta

200 - application/json

Successful Response

code · integer

Error code; specifically define the error code

message · string

error message

request_id · string

Request ID, system-generated, for tracking requests, troubleshooting issues

data · object

Show child attributes