Image
Kling Image 4.0
Crie imagens em 2K ou 4K com Kling Image 4.0. Use fotos de referência nomeadas, variações de uma única imagem ou uma série conectada e consulte o status até obter as URLs das imagens finalizadas.
Envie uma solicitação JSON para POST /v1/images/generations com o ID do modelo kling-image-4-0. Salve o ID da tarefa retornado. O mesmo endpoint aceita descrições somente em texto e descrições guiadas por referências.
Exemplo rápido
Esta solicitação gera uma imagem estática quadrada em 2K. Armazene sua chave de API na variável de ambiente SEEDROUTER_API_KEY.
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'Endpoint e cabeçalhos
Envie JSON para POST https://api.seedrouter.ai/v1/images/generations com Content-Type: application/json e Authorization: Bearer YOUR_API_KEY. Mantenha a chave no seu servidor.
Parâmetros
| Campo | Tipo | Valores e padrões |
|---|---|---|
model | string, obrigatório | kling-image-4-0 |
contents | array, obrigatório | Um prompt e de zero a dez imagens de referência. |
contents[].type | string, obrigatório | prompt ou refer_image. |
contents[].text | string | Obrigatório para o prompt. Limite de 50.000 caracteres em inglês e de 21.000 em outros idiomas. Em textos mistos, a soma das frações dos respectivos limites deve ser de no máximo um. |
contents[].url | string | Obrigatório para cada referência. Use uma URL HTTP(S) acessível para um JPEG ou PNG de até 30 MB. Ambos os lados devem ter pelo menos 300 pixels, e a proporção entre largura e altura deve estar entre 2:5 e 5:2. |
contents[].id | string | Nome exclusivo opcional para uma referência. Mencione o nome como @name no prompt. |
settings.result_type | string | single (padrão) para imagens independentes ou series para imagens relacionadas. |
settings.n | integer | De 1 a 9 imagens independentes. O padrão é 1. Usado somente no modo single. |
settings.series_amount | integer ou string | No modo series, de 2 a 4 imagens, padrão 4. No modo single, este campo é ignorado e pode ser um inteiro de 2 a 10 ou a string auto. |
settings.resolution | string | 2k (padrão) ou 4k. |
settings.aspect_ratio | string | auto (padrão), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 ou 21:9. |
options.watermark_info.enabled | boolean | Opcional. Somente false é aceito. |
Uma série baseada em uma foto de referência
Substitua a URL de exemplo por uma URL pública da foto do seu produto. Este exemplo solicita três imagens conectadas. Mantenha a instrução de cada quadro no mesmo prompt.
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}Recuperar todas as imagens
Copie o id da resposta POST para TASK_ID. Consulte este endpoint com a mesma chave até o status da tarefa ser completed ou failed.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Quando a tarefa for concluída, leia todas as URLs em output.data[].url. Uma tarefa pode retornar várias imagens. Se uma verificação de status for interrompida, consulte novamente o ID original. Consulte a referência de tarefas para entender o ciclo de vida e o índice de erros para ver os códigos de erro.
Preços
O total corresponde ao número de imagens de saída na resolução solicitada multiplicado pela tarifa vigente por imagem, mais uma cobrança por imagem de referência fornecida. Quatro imagens em 4K com duas referências custam quatro tarifas de saída em 4K e duas cobranças por referência. Solicitações com falha não são cobradas. Consulte as tarifas atuais.
Erros e dicas
Entradas inválidas retornam um erro de solicitação. Verifique se falta texto no prompt, se há IDs de referência duplicados ou configurações de resolução ou série não aceitas. Se a chamada inicial retornou um ID de tarefa, consulte esse ID antes de decidir se é necessário enviar outra solicitação.
Para uma descrição com várias referências, use um nome diferente para cada elemento retratado e diga ao modelo quais características visuais cada referência fornece. Inclua no prompt as instruções de câmera e a sequência de tomadas. Consulte o playground do Kling Image 4.0 e o esquema OpenAPI.
