Skip to main content
POST
cURL

Generación de imágenes

Para la referencia completa de parámetros, consulta la documentación oficial de Kling.
Usa este endpoint para crear imágenes fijas mediante la API de generación de imágenes de Kling. Admite solicitudes de solo texto y solicitudes con imágenes de referencia a través del mismo flujo de tareas asíncronas.

Primera solicitud

Comienza con model_name: kling-v3, prompt, n y aspect_ratio. Agrega imágenes de referencia, controles de fidelidad o campos avanzados solo después de que la primera solicitud devuelva una tarea utilizable. Omitir model_name usa un valor predeterminado de compatibilidad heredado, así que envía kling-v3 explícitamente para nuevas integraciones.

Leer la respuesta

Guarda el task_id devuelto y luego consulta periódicamente la ruta de consulta de imágenes de Kling correspondiente hasta que task_status alcance un estado terminal. Si tu flujo de trabajo necesita almacenamiento duradero, copia el recurso final en tu propia capa de almacenamiento después de que termine la generación.

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
prompt
string
requerido

Text prompt describing the image to generate. Maximum 2500 characters.

model_name
enum<string>
predeterminado:kling-v1

Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.

Opciones disponibles:
kling-v1,
kling-v1-5,
kling-v2,
kling-v2-1,
kling-v3
negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.

image
string

Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

image_reference
enum<string>

Reference mode for legacy image-to-image requests when image is provided.

Opciones disponibles:
subject,
face
image_fidelity
number
predeterminado:0.5

How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.

Rango requerido: 0 <= x <= 1
human_fidelity
number
predeterminado:0.45

Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.

Rango requerido: 0 <= x <= 1
element_list
object[]

Optional Kling element references. The total count of element references and input images must not exceed 10.

resolution
enum<string>
predeterminado:1k

Output resolution. Defaults to 1k.

Opciones disponibles:
1k,
2k
n
integer
predeterminado:1

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

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

Output aspect ratio (width:height).

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 to receive task status updates when the task completes.

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.