Generar imágenes con Kling
Genera imágenes con Kling a través de CometAPI: POST /kling/v1/images/generations admite la creación de imágenes guiada por prompt y la generación con imágenes de referencia.
Generación de imágenes
Primera solicitud
Comienza conmodel_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 eltask_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
Bearer token authentication. Use your CometAPI key.
Encabezados
Must be application/json.
Cuerpo
Text prompt describing the image to generate. Maximum 2500 characters.
Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.
kling-v1, kling-v1-5, kling-v2, kling-v2-1, kling-v3 Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.
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.
Reference mode for legacy image-to-image requests when image is provided.
subject, face How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.
0 <= x <= 1Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.
0 <= x <= 1Optional Kling element references. The total count of element references and input images must not exceed 10.
Output resolution. Defaults to 1k.
1k, 2k Number of images to generate. Range: 1-9.
1 <= x <= 9Output aspect ratio (width:height).
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 Watermark options.
Webhook URL to receive task status updates when the task completes.
Optional user-defined task ID for your own tracking. Must be unique per account.