Gerar imagens com Kling
Gere imagens com Kling via CometAPI: POST /kling/v1/images/generations oferece suporte à criação de imagens orientada por prompt e à geração com referência de imagem.
Geração de imagens
Primeira solicitação
Comece commodel_name: kling-v3, prompt, n e aspect_ratio. Adicione imagens de referência, controles de fidelidade ou campos avançados somente depois que a primeira solicitação retornar uma tarefa utilizável. Omitir model_name usa um padrão legado de compatibilidade, então envie kling-v3 explicitamente em novas integrações.
Leia a resposta
Salve otask_id retornado e, em seguida, faça polling da rota de consulta de imagens Kling correspondente até que task_status atinja um estado terminal. Se o seu fluxo de trabalho precisar de armazenamento persistente, copie o asset final para sua própria camada de armazenamento após a conclusão da geração.Autorizações
Bearer token authentication. Use your CometAPI key.
Cabeçalhos
Must be application/json.
Corpo
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.