Tutorial de Kling Image 4.0 Long Image
Crea diseños web y fichas ecommerce en 2K con Kling Image 4.0 Long Image. Dos casos reales en PNG, solicitudes cURL, consulta de estado y tarifas.
Leer en MarkdownLos modelos de imagen estándar producen un solo encuadre por vez. Cuando les pides una página de detalle de producto o un sitio completo de lanzamiento, acabas generando seis banners desconectados y peleándote con márgenes desalineados, tipografías cambiantes y escalas de producto incoherentes en un editor de maquetación. Kling Image 4.0 Long Image funciona de otro modo: una única solicitud a la API devuelve un PNG vertical continuo estructurado de arriba abajo, con un ancho fijo de 1K (1024 px) o 2K (2048 px) y una altura que depende de las secciones de tu brief.
El 19 de noviembre de 2026 ejecutamos dos tareas en 2K a través del endpoint /v1/images/generations de SeedRouter para poner a prueba ambos modos con briefs reales de producción. La primera ejecución usó el modo webpage solo con texto y devolvió una página de lanzamiento de 2048 × 16.385 px para una marca ficticia de auriculares de estudio (17 MB, 169 segundos). La segunda usó el modo ecommerce con extensión medium y dos fotografías existentes de joyería, devolviendo una página de detalle de producto de 2048 × 19.533 px (25 MB, 261 segundos). Abajo puedes inspeccionar ambos recorridos completos, probar cualquiera de los dos briefs en el Playground de Kling Image 4.0 Long Image y comprobar las tarifas exactas de cada nivel en la tabla en vivo más adelante.
Elige ecommerce o webpage antes de escribir una sola línea
El campo settings.skill es obligatorio y cambia tanto la gramática visual del diseño como los parámetros que acepta la API. Conviene tratar ambos modos como contratos distintos, no como simples ajustes cosméticos de estilo.
Usa ecommerce cuando ya tienes fotografía real de producto y necesitas una página vertical de detalle de producto (PDP) para una tienda online o un marketplace. En modo ecommerce, debes enviar entre una y tres entradas refer_image dentro de contents y controlar el presupuesto vertical de bloques con settings.length (short, medium o long, con medium como valor predeterminado). Las solicitudes sin referencias de producto se rechazan antes de facturarse.
Usa webpage cuando diseñas una landing page de marca, un sitio de lanzamiento o una maquetación web editorial. En modo webpage, las referencias son opcionales: puedes generar solo con texto o aportar como máximo un style_refer_image para marcar la paleta y el ritmo de retícula, y como máximo un subject_refer_image para anclar un objeto protagonista. No envíes refer_image ni settings.length en modo webpage; ambos campos pertenecen exclusivamente a ecommerce y provocarán un error de validación si los mezclas entre modos.
| Ajuste o entrada | Modo ecommerce | Modo webpage |
|---|---|---|
settings.skill | "ecommerce" (obligatorio) | "webpage" (obligatorio) |
settings.length | "short", "medium" (predeterminado) o "long" | Omitir por completo |
settings.resolution | "1k" (1024 px de ancho) o "2k" (2048 px de ancho) | "1k" (1024 px de ancho) o "2k" (2048 px de ancho) |
Entradas refer_image | Obligatorias: de 1 a 3 URL públicas en JPEG/PNG | No permitidas |
style_refer_image / subject_refer_image | No permitidas | Opcionales: hasta 1 de cada tipo |
Ninguno de los dos modos admite 4k, lotes (n) ni relaciones de aspecto. Cada tarea completada entrega exactamente una URL de PNG vertical en output.data[0].url.
Prueba 1: un diseño web en 2K solo con texto (2048 × 16.385)

Arriba tienes los cuatro tramos verticales de nuestra prueba en modo webpage a 2K dispuestos en paralelo. El brief pedía una página de lanzamiento de estilo industrial suizo en negro obsidiana para unos auriculares planares abiertos llamados S-01 Reference Planar: barra superior minimalista, fotografía principal en tres cuartos, franja acústica de tres columnas, corte técnico de mecanizado CNC, tabla de especificaciones técnicas con cifras eléctricas reales y un pie de página discreto.
Fíjate bien en lo que se mantuvo estable en una sola pasada continua. A lo largo de 16.385 píxeles verticales, el fondo carbón oscuro, los titulares con serifa y la geometría en aluminio cepillado del producto conservaron la coherencia desde la navegación superior hasta la tira de cinco acabados y la tabla técnica. Todas las cifras eléctricas solicitadas salieron legibles (106 mm Iso-Planar, 32 Ohms, 98 dB/mW, 8 Hz–52 kHz, 410 g). Hay un detalle menor que conviene señalar tras revisar el PNG completo al 100% de zoom: el prompt pedía una banda en alabastro claro detrás de la tabla de especificaciones, pero el modelo dejó la tabla sobre pizarra oscura y colocó la franja gris más clara en el bloque de suscripción al boletín situado justo debajo. Si un cambio exacto de color de fondo por sección es innegociable para el paso a ingeniería, trata la salida como dirección de arte visual y recorta o reconstruye esa banda en HTML a partir de la fotografía generada.
Redactar un buen brief para webpage se parece más a definir el esquema de un wireframe que a escribir el prompt de una foto suelta. Coloca primero los tokens globales de diseño (hexadecimal de fondo, materiales de superficie, color de acento, disciplina de retícula) y numera luego cada banda de arriba abajo con textos concretos para titulares y cifras clave. Si dejas los encabezados vagos, aparecerá texto de relleno.
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.jsonObserva que en esa solicitud se omite settings.length y contents solo contiene la entrada prompt. Puedes consultar el contrato completo de parámetros en la referencia de la API de Kling Image 4.0 Long Image. [1]
Prueba 2: una ficha ecommerce en 2K con dos referencias (2048 × 19.533)

Para la segunda ejecución cambiamos settings.skill a "ecommerce", fijamos settings.length en "medium", mantuvimos resolution en "2k" y enviamos dos fotografías existentes de joyería como entradas refer_image: una toma macro de un pendiente colgante de orquídea en oro esculpido con id: "earring", y un retrato editorial en un invernadero de una mujer llevando el mismo pendiente con id: "model".
En el prompt nos referimos a ambos activos mediante @earring y @model dentro de la descripción de cada sección. La API convierte automáticamente tus IDs con nombre en referencias posicionales, así que no tienes que contar índices a mano. Cada foto de referencia debe ser una URL pública en JPEG o PNG de hasta 30 MB, con al menos 300 px por lado y una relación de aspecto comprendida entre 2:5 y 5:2.

Esa única llamada medium en 2K generó 19.533 píxeles verticales repartidos en seis módulos ecommerce completos: portada del producto sobre seda champán, banda poética de inspiración de diseño, recorte limpio de estudio acompañado de una tabla de información de seis filas (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, cuadrícula multiángulo de seis vistas (Front, Side, Back, Core Detail, Hook Detail, Profile) y el diagrama anotado Craft And Beauty ampliado arriba.
La inspección a resolución completa también dejó ver un fallo que conviene tener en cuenta antes de publicar fichas generadas directamente en un catálogo real. Aunque la tabla técnica reprodujo el nombre exacto del modelo Phalaenopsis No. 4 Drop Earring y todas las etiquetas del diagrama salieron bien escritas, el banner superior acortó Botanical Series a BOTA SERIES y BOTA — Drop Earring en lugar de imprimir el nombre de marca pedido L'ORCHIDÉE. Es un patrón habitual al renderizar texto en páginas largas: las etiquetas breves y las filas de especificaciones suelen ser muy estables, mientras que los logotipos tipográficos estilizados en mayúsculas en la cabecera a veces derivan. Revisa siempre el titular principal a ancho completo y superpón como vectores en tu plantilla de tienda los logotipos registrados y la letra pequeña legal.
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.jsonSi en cambio utilizas referencias en modo webpage, ten presente una regla de organización: usa style_refer_image para la dirección estética y subject_refer_image para un producto protagonista, asignando a cada uno un id alfanumérico distinto (de 1 a 32 caracteres, sin espacios) y citándolo con @id en el prompt. No dupliques nunca los IDs dentro del mismo array contents.
Consulta el estado con paciencia y prevé descargas PNG 2K pesadas
Los diseños verticales largos tardan bastante más que una generación normal de una sola imagen y devuelven archivos mucho más pesados. Tratarlos como una API de miniaturas de cinco segundos es la vía más rápida para provocar timeouts en el cliente o cargos duplicados por reintentos accidentales.
En nuestras pruebas del 19 de noviembre, la página web de 2048 × 16.385 terminó en 169 segundos (17 MB) y la ficha ecommerce media de 2048 × 19.533 tardó 261 segundos (25 MB). Las páginas ecommerce largas en 2K pueden superar los siete minutos y pesar más de 50 MB. Guarda el ID de tarea nada más recibir la respuesta de POST /v1/images/generations, consulta GET /v1/tasks/{id} cada 15 o 20 segundos y no vuelvas a lanzar otro POST solo porque se corte una sesión de terminal o venza un timeout local. [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.jsonCuando status devuelva completed, extrae la única URL del PNG desde output.data[0].url y descárgala directamente a disco con un margen de tiempo generoso:
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.pngEn workers de backend, evita cargar el PNG entero en un búfer de memoria fijo antes de escribirlo a disco o a almacenamiento de objetos. Envía el cuerpo de la respuesta HTTP en streaming directo a un archivo, comprueba sus dimensiones antes de trocear las secciones para tiendas móviles y convierte las vistas previas a WebP conservando el PNG original para impresión o exportación por bloques.
Presupuesta los ocho niveles de salida y las imágenes de referencia
El precio de Kling Image 4.0 Long Image depende de tres decisiones: skill (ecommerce frente a webpage), length (short, medium o long en modo ecommerce) y resolution (1k frente a 2k). Cada imagen de referencia de entrada (refer_image, style_refer_image o subject_refer_image) añade un cargo por imagen de entrada desde la primera foto, sin cuota gratuita inicial.
Esto simplifica mucho la estrategia de trabajo. Cuando iteres sobre el orden de secciones, el ritmo de titulares y la jerarquía cromática de un catálogo ecommerce, haz pruebas primero en 1k short o medium, revisa el recorrido vertical y salta a 2k cuando el brief ya funcione. En diseños webpage, la diferencia entre 1k y 2k es lo bastante reducida como para que merezca la pena elegir 2k en cuanto necesites tablas de especificaciones nítidas en cuerpo pequeño. Nuestra primera ejecución se liquidó con la tarifa exacta de webpage 2K; la segunda, con la de ecommerce medium 2K más dos cargos de imagen de entrada. Las solicitudes fallidas no tienen coste. Consulta las cifras actuales abajo o introduce tus parámetros exactos en la calculadora de precios de Kling Image 4.0 Long Image. [3]
Cuánto cuesta Kling Image 4.0 Long Image
| Categoría | Precios (USD) |
|---|---|
| Ecommerce · 1K · short | 0,2269 US$ |
| Ecommerce · 2K · short | 0,2723 US$ |
| Ecommerce · 1K · medium | 0,4538 US$ |
| Ecommerce · 2K · medium | 0,5294 US$ |
| Ecommerce · 1K · long | 0,7563 US$ |
| Ecommerce · 2K · long | 0,8319 US$ |
| Webpage · 1K | 0,5294 US$ |
| Webpage · 2K | 0,5748 US$ |
| Imagen de referencia | 0,003025 US$ |
Preguntas frecuentes
¿Cómo elijo entre short, medium y long en modo ecommerce?
Cuenta los módulos diferenciados que realmente necesita tu producto antes de escoger length. Una página short encaja con tres o cuatro bloques concisos: portada, ventajas principales y un bloque compacto de especificaciones. Una página medium aloja con holgura seis secciones como en la prueba de joyería anterior (portada, historia, recorte de estudio, tabla de especificaciones, retrato de uso, cuadrícula multiángulo y diagrama anotado). Reserva long para hardware técnico o fichas con varias variantes donde necesites tablas comparativas, paneles de uso paso a paso y desglose del embalaje sin apelmazar la tipografía.
¿Por qué mi solicitud en modo webpage devolvió un error HTTP 400?
Los dos fallos de validación más frecuentes son enviar settings.length junto con skill: "webpage" y etiquetar una foto de referencia con type: "refer_image" en lugar de style_refer_image o subject_refer_image. Ambos elementos son exclusivos del modo ecommerce. Verifica también que el prompt respete el límite ponderado de caracteres (en / 166000 + non_en / 71000 <= 1, evaluado tras mapear las menciones @id) y que resolution sea "1k" o "2k".
¿Conviene trocear el PNG final para una tienda web en producción?
Sí. Un PNG de 2048 × 19.533 pesa entre 17 y 25 MB sin comprimir, demasiado para servirlo como una sola etiqueta <img> en redes móviles. Corta la página final por las fronteras horizontales entre bandas, comprime cada bloque a WebP o AVIF para lograr una carga progresiva rápida y sustituye las marcas legales críticas, precios o botones de compra por texto HTML real. Puedes probar prompts e inspeccionar resultados a altura completa directamente en el Playground de Kling Image 4.0 Long Image antes de automatizar tu flujo.



