Saltar al contenido principal
POST
/
kling
/
v1
/
images
/
generations
Multi-Image to Image
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"
    }
  ]
}
'
{
  "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.

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