Image
Kling Image 4.0 Long Image
Gere páginas longas de detalhes de produto para e-commerce e designs visuais de páginas web em 1K ou 2K com Kling Image 4.0 Long Image, e consulte o status até obter a URL do PNG finalizado.
Envie uma solicitação JSON para POST /v1/images/generations com o ID do modelo kling-image-4-0-long-image. Salve o ID da tarefa retornado e consulte GET /v1/tasks/{id} até que o PNG longo único seja finalizado.
Exemplo rápido
Esta solicitação cria um layout de página web em 1K a partir de um briefing em texto. 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-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'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-long-image |
contents | array, obrigatório | Um item prompt mais itens de imagem de referência específicos do modo. |
contents[].type | string, obrigatório | prompt, refer_image (somente ecommerce, 1–3 obrigatórios), style_refer_image (somente webpage, no máximo 1) ou subject_refer_image (somente webpage, no máximo 1). element não é suportado. |
contents[].text | string | Obrigatório para prompt. Limite de 166.000 caracteres apenas em inglês ou 71.000 em outros idiomas. Texto misto deve satisfazer english / 166000 + non_english / 71000 <= 1. |
contents[].url | string | Obrigatório para cada item de imagem. URL pública HTTP(S) de um arquivo JPEG ou PNG de até 30 MB, com pelo menos 300 px por lado e proporção de 2:5 a 5:2. |
contents[].id | string | ID de referência exclusivo opcional entre todos os itens de imagem da solicitação. Mencione-o como @id no prompt. |
settings.skill | string, obrigatório | ecommerce para páginas de detalhes de produto ou webpage para designs de página web. |
settings.length | string | short (~2–5 seções), medium (padrão, ~6–10 seções) ou long (~11–18 seções). Aplica-se apenas a ecommerce; ignorado em webpage. |
settings.resolution | string | 1k (padrão, 1024 px de largura) ou 2k (2048 px de largura). A altura se adapta ao conteúdo. 4k não é suportado. |
options.watermark_info.enabled | boolean | Opcional. Apenas false é suportado. |
Página de detalhes de produto para e-commerce
O modo ecommerce exige de 1 a 3 entradas refer_image. Referencie cada foto pelo respectivo id no prompt.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}Design de página web com referências de estilo e assunto
O modo webpage aceita entradas opcionais style_refer_image (no máximo 1) e subject_refer_image (no máximo 1). Omita settings.length no modo webpage.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}Obter a imagem longa
Copie id da resposta do POST para TASK_ID e consulte o status até que ele mude para completed ou failed. Tarefas de imagem longa costumam levar vários minutos, especialmente em layouts long + 2k.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Quando concluir, leia output.data[0].url. Cada solicitação gera um único PNG longo completo. Em 2k, páginas longas podem ultrapassar 50 MB, portanto ajuste os timeouts de download e a escala de visualização de acordo. Consulte a referência de tarefas e o diretório de erros.
Preços
Cada solicitação concluída cobra a tarifa de uma faixa de saída (ecommerce por resolution × length, ou webpage por resolution) mais uma cobrança de imagem de referência por imagem enviada (incluindo a primeira). Pedidos com falha não são cobrados. Confira as tarifas atuais.
Erros e dicas
Solicitações inválidas retornam HTTP 400 antes da cobrança. Os erros de validação mais comuns incluem omitir settings.skill, enviar ecommerce sem 1–3 URLs de refer_image, misturar refer_image com o modo webpage, solicitar 4k ou duplicar IDs de referência.
Informe a ordem exata das seções no prompt — do banner principal até as especificações ou rodapé — e inclua apenas dados verificados do produto para manter o layout preciso. Acesse o playground de Kling Image 4.0 Long Image e o esquema OpenAPI.
