Tutorial de Kling Image 4.0 Long Image
Crie páginas web e de produto em 2K com Kling Image 4.0 Long Image. Veja dois testes reais em PNG longo, payloads cURL, polling e tarifas atuais.
Ler em MarkdownModelos comuns de imagem geram um quadro por vez. Quando você pede a eles uma página de detalhes de produto ou um site completo de lançamento, acaba gerando seis banners desconexos e perdendo tempo em um editor de layout para corrigir margens desalinhadas, fontes que mudam de bloco em bloco e proporções inconsistentes do produto. Kling Image 4.0 Long Image funciona de outro jeito: uma única chamada de API devolve um PNG vertical contínuo estruturado de cima a baixo, com largura fixa em 1K (1024 px) ou 2K (2048 px) e altura definida pelas seções do seu briefing.
Em 19 de novembro de 2026, rodamos duas tarefas em 2K pelo endpoint /v1/images/generations do SeedRouter para testar os dois modos com briefings reais de produção. O primeiro teste usou o modo webpage somente com texto e retornou uma página de lançamento de 2048 × 16385 px para uma marca fictícia de fones de estúdio (17 MB, 169 segundos). O segundo teste usou o modo ecommerce na extensão medium com duas fotos existentes de joalheria e entregou uma página de detalhes de produto de 2048 × 19533 px (25 MB, 261 segundos). Você pode conferir as duas páginas completas abaixo, testar qualquer um dos briefings no playground de Kling Image 4.0 Long Image e verificar as tarifas exatas por faixa na tabela em tempo real mais adiante.
Escolha ecommerce ou webpage antes de escrever uma linha
O campo settings.skill é obrigatório e altera tanto a gramática visual do layout quanto os parâmetros aceitos pela API. Trate os dois modos como contratos distintos, e não como meros presets cosméticos de estilo.
Use ecommerce quando você já tiver fotos reais do produto e precisar de uma página vertical de detalhes (PDP) para loja virtual ou marketplace. No modo ecommerce, você precisa enviar entre uma e três entradas refer_image em contents e controlar a extensão vertical com settings.length (short, medium ou long, com padrão medium). Solicitações sem fotos de referência do produto são rejeitadas antes da cobrança.
Use webpage quando estiver projetando uma landing page de marca, um site de lançamento ou um layout editorial para a web. No modo webpage, as referências são opcionais: você pode rodar apenas com texto ou enviar no máximo uma style_refer_image para orientar paleta e ritmo de grade e no máximo uma subject_refer_image para manter um objeto em destaque. Não envie refer_image nem settings.length no modo webpage; ambos pertencem exclusivamente a solicitações ecommerce e geram erro de validação se misturados entre modos.
| Configuração ou entrada | Modo ecommerce | Modo webpage |
|---|---|---|
settings.skill | "ecommerce" (obrigatório) | "webpage" (obrigatório) |
settings.length | "short", "medium" (padrão) ou "long" | Omita completamente |
settings.resolution | "1k" (1024 px de largura) ou "2k" (2048 px de largura) | "1k" (1024 px de largura) ou "2k" (2048 px de largura) |
Entradas refer_image | Obrigatório: 1 a 3 URLs públicas JPEG/PNG | Não permitido |
style_refer_image / subject_refer_image | Não permitido | Opcional: até 1 de cada |
Nenhum dos modos aceita 4k, contagem em lote (n) ou proporções personalizadas. Toda tarefa concluída entrega exatamente uma URL de PNG longo em output.data[0].url.
Teste 1: Um layout de página web 2K somente com texto (2048 × 16385)

Acima estão os quatro quartos verticais do nosso teste webpage em 2K dispostos lado a lado. O briefing pediu uma página de lançamento industrial suíça em ardósia obsidiana escura para um fone planar aberto chamado S-01 Reference Planar: barra superior minimalista, fotografia principal em três quartos, faixa de destaques acústicos em três colunas, corte explodido da usinagem CNC, tabela de especificações técnicas com dados elétricos reais e um rodapé discreto.
Repare no que se manteve íntegro em uma única passagem contínua. Ao longo de 16.385 pixels verticais, o fundo carvão escuro, os títulos com serifa e a geometria em alumínio escovado do produto permaneceram coesos desde a barra de navegação superior até a faixa com cinco opções de acabamento e a tabela técnica. Todos os valores elétricos solicitados saíram legíveis (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). Um detalhe que vale registrar após inspecionar o PNG completo em zoom de 100%: o prompt pedia uma faixa clara em alabastro atrás da tabela de especificações, mas o modelo manteve a tabela no fundo escuro e aplicou o tom cinza mais claro no bloco de assinatura de newsletter logo abaixo. Se uma troca exata de cor de fundo em determinada seção for obrigatória para a entrega ao time de front-end, use o PNG como direção de arte visual e recorte ou reconstrua aquela faixa em HTML aproveitando a fotografia gerada.
Escrever um bom briefing de webpage lembra mais redigir um roteiro de wireframe do que um prompt de foto avulsa. Coloque os tokens globais de design primeiro (hexadecimal do fundo, material das superfícies, cor de destaque, disciplina da grade) e depois numere cada faixa de cima para baixo com textos concretos para títulos e números principais. Deixar títulos vagos abre espaço para texto genérico de preenchimento.
curl --fail-with-body -sS 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 vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
}],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}' -o solstice-task.json
jq -er '.id' solstice-task.jsonObserve que settings.length foi omitido nesse payload e que contents traz apenas o item prompt. Você pode conferir o contrato completo de parâmetros na referência da API de Kling Image 4.0 Long Image. [1]
Teste 2: Uma página de detalhes de e-commerce 2K com duas referências (2048 × 19533)

Para o segundo teste, mudamos settings.skill para "ecommerce", definimos settings.length como "medium", mantivemos resolution em "2k" e enviamos duas fotografias reais de joalheria como entradas refer_image: uma foto macro de um brinco pendente de orquídea em ouro esculpido com id: "earring" e um retrato editorial em estufa de uma mulher usando o mesmo brinco com id: "model".
No prompt, mencionamos essas duas peças como @earring e @model na descrição de cada seção. A API converte automaticamente os IDs nomeados em referências posicionais, evitando que você precise contar índices na mão. Cada foto de referência precisa ser uma URL pública JPEG ou PNG de até 30 MB, com no mínimo 300 px em cada lado e proporção entre 2:5 e 5:2.

Essa única chamada de extensão média em 2K gerou 19.533 pixels verticais distribuídos em seis módulos completos de e-commerce: destaque principal do produto sobre seda champanhe, faixa poética de inspiração de design, recorte limpo de estúdio acompanhado de tabela técnica com seis linhas (Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box), retrato On The Ear fiel a @model, grade com seis ângulos do produto (Front, Side, Back, Core Detail, Hook Detail, Profile) e o diagrama anotado Craft And Beauty ampliado acima.
A revisão em resolução total também pegou uma falha que vale destacar antes de publicar páginas geradas direto em um catálogo no ar. Embora a tabela de especificações tenha trazido o nome exato Phalaenopsis No. 4 Drop Earring e todas as legendas do diagrama estivessem corretas, o banner do topo encurtou Botanical Series para BOTA SERIES e BOTA — Drop Earring em vez de exibir o nome solicitado L'ORCHIDÉE. Esse é um comportamento típico em renderização de texto em páginas longas: rótulos curtos e linhas de tabela costumam sair muito estáveis, enquanto logotipos estilizados em caixa alta no topo às vezes sofrem variação. Sempre revise o título do hero em largura real e mantenha marcas registradas ou textos legais exatos como camadas vetoriais no template da loja.
curl --fail-with-body -sS 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": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
},
{
"type": "refer_image",
"id": "earring",
"url": "https://example.com/assets/gold-orchid-earring.png"
},
{
"type": "refer_image",
"id": "model",
"url": "https://example.com/assets/editorial-portrait.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}' -o orchidee-task.json
jq -er '.id' orchidee-task.jsonSe você optar por usar referências no modo webpage, lembre-se de uma regra simples: envie style_refer_image para direção estética e subject_refer_image para o produto em foco, atribuindo a cada uma um id alfanumérico distinto (de 1 a 32 caracteres, sem espaços) e citando-o com @id no prompt. Nunca repita o mesmo ID dentro do array contents.
Faça polling com calma e planeje downloads pesados de PNG em 2K
Layouts verticais longos demoram bem mais do que gerações comuns de quadro único e produzem arquivos muito mais pesados. Tratá-los como uma API de miniaturas de cinco segundos é o caminho mais rápido para sofrer timeouts no cliente ou gerar cobranças duplicadas por engano.
Nos nossos testes de 19 de novembro, a página web de 2048 × 16385 terminou em 169 segundos (17 MB), e a página média de e-commerce de 2048 × 19533 terminou em 261 segundos (25 MB). Páginas de e-commerce no modo long em 2K podem passar de sete minutos e ultrapassar 50 MB. Salve o ID da tarefa imediatamente após o retorno de POST /v1/images/generations, consulte GET /v1/tasks/{id} a cada 15 a 20 segundos e nunca reenvie um segundo POST só porque a sessão do terminal caiu ou o cliente deu timeout. [2]
TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.jsonAssim que status mostrar completed, extraia a URL única do PNG em output.data[0].url e grave o arquivo em disco com um timeout de transferência folgado:
IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.pngEm workers de backend, evite carregar o PNG inteiro em um buffer fixo pequeno na memória antes de gravar em disco ou no object storage. Faça streaming do corpo da resposta HTTP direto para um arquivo, inspecione as dimensões antes de fatiar as seções para lojas mobile e converta as prévias de exibição para WebP, guardando o PNG original para impressão ou novos recortes.
Planeje o orçamento nas oito faixas de saída e imagens de referência
O preço de Kling Image 4.0 Long Image depende de três escolhas: skill (ecommerce ou webpage), length (short, medium ou long no modo ecommerce) e resolution (1k ou 2k). Cada imagem de referência enviada (refer_image, style_refer_image ou subject_refer_image) soma uma cobrança de imagem de entrada desde a primeira foto, sem cota gratuita.
Isso deixa a estratégia de rascunho bem direta. Ao iterar sobre ordem das seções, ritmo de títulos e hierarquia de cores de um catálogo de e-commerce, teste primeiro em 1k short ou medium, avalie o fluxo vertical e só então passe para 2k quando o briefing estiver redondo. Para layouts webpage, a diferença entre 1k e 2k costuma ser pequena o bastante para justificar escolher 2k logo que você precisar de tabelas técnicas com texto miúdo bem nítido. Nosso primeiro teste foi cobrado exatamente na faixa webpage 2K; o segundo fechou na faixa ecommerce medium 2K mais duas cobranças de imagem de entrada. Pedidos com falha não são cobrados. Confira os valores ao vivo abaixo ou simule sua combinação exata na calculadora de preços de Kling Image 4.0 Long Image. [3]
Quanto custa Kling Image 4.0 Long Image
| Categoria | Preços (USD) |
|---|---|
| E-commerce · 1K · curto | US$ 0,2269 |
| E-commerce · 2K · curto | US$ 0,2723 |
| E-commerce · 1K · médio | US$ 0,4538 |
| E-commerce · 2K · médio | US$ 0,5294 |
| E-commerce · 1K · longo | US$ 0,7563 |
| E-commerce · 2K · longo | US$ 0,8319 |
| Página web · 1K | US$ 0,5294 |
| Página web · 2K | US$ 0,5748 |
| Imagem de referência | US$ 0,003025 |
Perguntas frequentes
Como escolher entre short, medium e long no modo ecommerce?
Conte quantos módulos distintos o produto realmente precisa antes de definir length. Uma página short acomoda de três a quatro faixas diretas, como destaque principal, benefícios-chave e um bloco compacto de especificações. Uma página medium comporta seis seções com folga, como no teste de joalheria acima (hero, inspiração, recorte de estúdio, tabela técnica, foto de uso, grade multiângulo e diagrama anotado). Deixe long para eletrônicos técnicos ou anúncios com múltiplos SKUs que exijam tabelas comparativas, guias de uso passo a passo e detalhamento da embalagem sem apertar a tipografia.
Por que minha solicitação webpage retornou HTTP 400?
Os dois erros de validação mais frequentes são enviar settings.length junto com skill: "webpage" e marcar uma foto de referência com type: "refer_image" em vez de style_refer_image ou subject_refer_image. Ambos os campos são exclusivos do modo ecommerce. Confira também se o prompt respeita o limite ponderado de caracteres (en / 166000 + non_en / 71000 <= 1, validado após o mapeamento das menções @id) e se resolution está definido como "1k" ou "2k".
Devo fatiar o PNG final para uma loja virtual em produção?
Sim. Um PNG de 2048 × 19533 pesa entre 17 e 25 MB sem compressão e é pesado demais para ir ao ar como uma única tag <img> em redes móveis. Fatie a página final nos limites horizontais de cada faixa, comprima cada bloco em WebP ou AVIF para carregamento progressivo rápido e substitua marcas legais críticas, preços ou botões de compra por texto HTML real. Você pode testar prompts e inspecionar resultados em altura completa direto no playground de Kling Image 4.0 Long Image antes de automatizar seu pipeline.



