· reAPI Team
Tutorial de Kling Image 4.0 Long Image
Aprende a usar Kling Image 4.0 Long Image en reAPI para páginas de detalle de ecommerce y diseños de páginas web, con reglas de modo, ID de referencia, precios y pasos de revisión.

La mayoría de los generadores de imágenes te entregan un fotograma cuadrado o 16:9 cada vez. Cuando necesitas una página completa de detalle de producto para ecommerce o una landing page vertical continua, unir seis imágenes fijas por separado casi siempre rompe la iluminación, los márgenes y la tipografía en cada unión. Kling Image 4.0 Long Image resuelve ese problema renderizando un único PNG vertical largo y continuo desde el bloque principal superior hasta el pie de página en una sola solicitud.[1]
Este tutorial recorre el contrato exacto en reAPI tanto para el modo webpage como para el modo ecommerce, incluyendo las reglas de imágenes de referencia, las menciones @id, la planificación de resolución 1K frente a 2K, los precios actuales de reAPI por página comprobados el 20 de noviembre de 2026 y las comprobaciones de consulta e inspección de archivos necesarias para PNG largos.[2]
Resumen rápido
- Dos skills distintos:
settings.skilles obligatorio en cada llamada. Eligewebpagepara conceptos completos de landing page (de 0 a 2 referencias opcionales, omitesettings.length) oecommercepara páginas de detalle de producto (de 1 a 3 fotosrefer_imageobligatorias más profundidadshort,mediumolong).[1] - Un PNG largo por tarea: El ancho de salida es fijo en 1K (1024 px) o 2K (2048 px), mientras que la altura vertical se adapta a las secciones de tu brief.
4kno es compatible.[2] - Los roles de referencia no se pueden mezclar:
refer_imagesolo funciona en modoecommerce;style_refer_imageysubject_refer_imagesolo funcionan en modowebpage. Las referencias de elementos no son compatibles.[2] - Facturación por página: Comprobado el 20 de noviembre de 2026, las tarifas de reAPI van desde 0,2269 US$ (
ecommerce,short,1k) hasta 0,8319 US$ (ecommerce,long,2k), conwebpageen 0,5294 US$ (1k) o 0,5748 US$ (2k), más 0,003025 US$ por cada imagen de referencia de entrada a partir de la primera. Consulta la tabla de precios en vivo.[3] - Ten en cuenta renderizados largos y archivos pesados: Los renderizados de varias secciones suelen tardar varios minutos, y los PNG largos en 2K pueden superar los 50 MB. Ajusta los tiempos de espera de descarga HTTP y los visores de imágenes en consecuencia.[2]
Empieza con un brief de webpage en 1K
Antes de subir varias fotos de producto o pagar por un diseño largo en 2K, envía una única solicitud webpage solo con texto a Kling Image 4.0 Long Image en 1K de ancho. Una tarea webpage en 1K te permite verificar el ritmo vertical de las secciones, el contraste de color y la jerarquía visual sin gastar tiempo extra en píxeles de alta resolución ni en la configuración de referencias.
Enumera cada sección en orden exacto de arriba abajo dentro de un único elemento prompt. Nombra el banner principal, las bandas intermedias de características, cualquier cuadrícula o franja comparativa y el bloque de cierre del pie de página. Una petición vaga como «haz una web moderna de café» deja el número de secciones y el ritmo visual al azar, mientras que un esquema vertical numerado te da una lista de verificación concreta cuando revises el resultado.
curl https://reapi.ai/api/v1/images/generations \
-H 'Authorization: Bearer YOUR_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. Section 1: full-bleed hero banner with warm morning light over a pour-over bar and headline space on the left. Section 2: three single-origin bean cards with origin notes and roast level tags. Section 3: brewing guide strip showing grind size, water temperature, and pour timing. Section 4: minimal footer with cafe address and opening hours."
}
],
"settings": {
"skill": "webpage",
"resolution": "1k"
}
}'El endpoint devuelve un objeto JSON que contiene el id de tu tarea y status: "processing". Guarda ese ID de inmediato. A diferencia de los endpoints de imágenes individuales que terminan en diez segundos, un diseño continuo de múltiples secciones tarda más en renderizarse. Consulta GET /api/v1/tasks/{id} con la misma clave bearer hasta que status cambie a completed o failed.[4]
Elige el modo ecommerce o webpage en Kling Image 4.0 Long Image
Cada solicitud a Kling Image 4.0 Long Image requiere settings.skill. Elegir el modo correcto importa porque cada skill impone sus propios tipos de referencia y controles de longitud, y mezclarlos provoca un error de validación antes de la facturación.[2]
| Regla | Modo ecommerce | Modo webpage |
|---|---|---|
| Resultado objetivo | Página de detalle de producto con varias secciones | Diseño visual de página web de desplazamiento completo |
| Tipos de referencia permitidos | Solo refer_image | Solo style_refer_image y subject_refer_image |
| Cantidad de referencias | De 1 a 3 obligatorias | De 0 a 1 de estilo y de 0 a 1 de sujeto (ambas opcionales) |
settings.length | short, medium (predeterminado) o long | Se ignora (omítelo de la solicitud) |
settings.resolution | 1k (predeterminado) o 2k | 1k (predeterminado) o 2k |
options.watermark_info.enabled | Solo false | Solo false |
Usa el modo ecommerce en Kling Image 4.0 Long Image siempre que ya tengas fotografía real de producto y necesites una ficha vertical cohesiva para una tienda online. Los tres niveles de longitud corresponden a conteos aproximados de secciones documentados por el creador: short apunta aproximadamente a entre 2 y 5 secciones, medium apunta aproximadamente a entre 6 y 10 secciones y long apunta aproximadamente a entre 11 y 18 secciones.[1]
Usa el modo webpage en Kling Image 4.0 Long Image cuando estés prototipando una landing page de marca, una página de lanzamiento o un micrositio editorial en el que puedas empezar solo con texto o combinar una referencia de estilo visual con una fotografía principal del sujeto. Como el modo webpage determina la profundidad vertical a partir de tu lista de secciones y no de un enum length, omitir settings.length mantiene las solicitudes limpias y alineadas con el esquema.
Configura referencias con nombre sin romper la validación
Las imágenes de referencia son la palanca principal para mantener un producto real reconocible a lo largo de un desplazamiento de Kling Image 4.0 Long Image. Cada elemento de referencia en contents acepta un type, una url HTTP o HTTPS accesible públicamente y un id único opcional. La pasarela de reAPI rechaza cadenas Base64 y URI data:.[2]
Cada archivo de referencia debe superar cuatro comprobaciones de formato antes del envío:
- Formato: Solo JPEG o PNG.
- Tamaño de archivo: Como máximo 30 MB por imagen.
- Dimensiones mínimas: Al menos 300 píxeles tanto de ancho como de alto.
- Relación de aspecto: Entre 2:5 y 5:2.
Comprueba cada enlace de referencia en una ventana del navegador sin sesión iniciada antes de llamar al endpoint. Las URL de recursos protegidas por cookies de panel que caducan fallan cuando el worker de renderizado intenta descargarlas.
Ejemplo de página de detalle de producto ecommerce
En el modo ecommerce de Kling Image 4.0 Long Image, proporciona entre una y tres entradas refer_image y asigna a cada ángulo un id corto y claro, como front y spout. Cita esos nombres directamente como @front y @spout en el prompt para que el diseño sepa qué fotografía ancla el banner principal y cuál dirige una banda de llamada macro.
{
"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 a medium ecommerce product detail page for the brushed-steel gooseneck kettle in @front. Section 1: full-bleed hero showing @front on warm travertine stone with clean headline space. Section 2: three core benefit callouts covering pour precision, balanced handle ergonomics, and stainless body durability. Section 3: close-up detail band highlighting the curved spout from @spout with flow-control annotations. Section 4: morning pour-over brewing lifestyle scene. Section 5: care instructions and verified specification list."
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}Ejemplo de referencia de estilo y sujeto en webpage
En el modo webpage de Kling Image 4.0 Long Image, separa la dirección estética del producto en sí. Adjunta como máximo un style_refer_image para guiar la paleta de colores, el ritmo de cuadrícula y el estilo tipográfico, y como máximo un subject_refer_image para mantener fiel un objeto físico. Cada id dentro de la solicitud debe ser único.
{
"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 tall watch launch webpage that matches the pale sandstone palette and editorial grid rhythm of @layout while showcasing @watch. Section 1: hero header featuring @watch at center-right. Section 2: three-column craft overview covering case finish, crystal clarity, and strap taper. Section 3: close-up dial and lug detail strip. Section 4: full technical specifications grid and clean minimal footer."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}Vigila el límite ponderado de prompt al redactar briefs extensos. Kling Image 4.0 Long Image acepta hasta 166 000 caracteres en inglés o 71 000 caracteres en otros idiomas, con texto mixto restringido por english / 166000 + non_english / 71000 <= 1. Ese límite se vuelve a comprobar después de mapear los nombres @id a marcadores posicionales, así que deja un pequeño margen de seguridad si tu prompt está cerca del techo.[2]
Planifica presupuestos entre 1K, 2K y niveles de longitud
A diferencia de los generadores estándar de imágenes fijas que facturan por mosaico de salida, Kling Image 4.0 Long Image tarifa cada solicitud completada como una tarifa de nivel de resultado más un cargo por cada imagen de referencia de entrada (incluida la primera referencia). Las generaciones fallidas que no entregan ningún resultado liberan automáticamente sus créditos reservados.[2]
La siguiente tabla muestra las tarifas actuales de reAPI comprobadas el 20 de noviembre de 2026 (1 crédito = 0,001 US$, 1 US$ = 1000 créditos). Confirma siempre las tarifas vigentes en la página de precios de Kling Image 4.0 Long Image antes de ejecutar lotes grandes.[3]
| Nivel | Resolución | Tarifa de reAPI (comprobada el 20 nov 2026) | Uso habitual |
|---|---|---|---|
ecommerce · short | 1k / 2k | 0,2269 US$ / 0,2723 US$ | Resumen compacto de producto de 2–5 secciones |
ecommerce · medium | 1k / 2k | 0,4538 US$ / 0,5294 US$ | Página estándar de detalle de tienda de 6–10 secciones |
ecommerce · long | 1k / 2k | 0,7563 US$ / 0,8319 US$ | Ficha insignia completa de 11–18 secciones |
webpage | 1k / 2k | 0,5294 US$ / 0,5748 US$ | Landing page completa o diseño de campaña |
| Imagen de referencia de entrada | Cualquiera | 0,003025 US$ cada una | Se cobra una vez por cada foto de referencia enviada |
Para un cálculo práctico concreto con esas tarifas del 20 de noviembre de 2026: una solicitud ecommerce medium 2k con dos fotos de producto suma 0,5294 US$ + 2 × 0,003025 US$ = 0,53545 US$. Al enviarla, reAPI reserva ceil(0.53545 × 1000) = 536 créditos enteros y luego liquida al completarse en microdólares exactos, devolviendo la diferencia fraccionaria a tu saldo.[2]
Una forma práctica de controlar el gasto en Kling Image 4.0 Long Image es un flujo de trabajo en dos pasadas. Haz el borrador del orden de diseño y de los textos de las secciones en 1k (o en ecommerce short 1k cuando valides primero la fidelidad del producto), inspecciona cada banda y pasa a 2k solo cuando la secuencia visual esté cerrada.
Consulta de forma fiable e inspecciona los PNG verticales
Después de enviar una solicitud a Kling Image 4.0 Long Image, consulta GET /api/v1/tasks/{id} a un intervalo constante, como cada 5 a 10 segundos, con un presupuesto de tiempo de espera del cliente de al menos 15 a 20 minutos para trabajos long + 2k. No reintentes automáticamente POST /v1/images/generations cuando falle puntualmente una consulta de estado; cada nuevo POST crea una tarea facturable distinta.[4]
Cuando status llegue a completed, lee la única URL en output.image_urls[0] y copia el PNG a tu propio almacenamiento de inmediato. Como los diseños largos en 2K pueden superar los 50 MB y abarcar más de 15 000 píxeles en vertical, descarga el flujo directamente a disco en lugar de almacenar archivos completos en la memoria de funciones serverless pequeñas, e inspecciona el resultado en dos pasadas:
- Revisión en miniatura a altura completa: Aleja el zoom para comprobar el ritmo visual, la coherencia del color de arriba abajo y las separaciones claras entre secciones.
- Revisión de recorte sección por sección al 100%: Comprueba el titular principal, las siluetas del producto, los acabados de materiales, las etiquetas de llamada y el bloque inferior de especificaciones a escala nativa de píxel.
Incluye únicamente dimensiones del producto, condiciones de garantía y especificaciones técnicas verificadas en tu brief. Comprobar la exactitud del texto al 100% de zoom detecta cifras deformadas o caracteres perdidos antes de que el diseño pase al troceado para tienda o al desarrollo front-end.
Preguntas frecuentes
¿Puedo generar una página vertical en 4K con Kling Image 4.0 Long Image?
No. Kling Image 4.0 Long Image solo admite salidas en 1k (1024 px de ancho) y 2k (2048 px de ancho). Las solicitudes que especifican 4k se rechazan con un error de validación antes de reservar créditos. Para imágenes fijas individuales en 4K o conjuntos de varias tomas, usa Kling Image 4.0.
¿Por qué mi solicitud de ecommerce falló la validación con cero referencias?
El modo ecommerce requiere entre 1 y 3 elementos refer_image en contents para que el modelo pueda basar cada sección vertical en fotos reales del producto. Si quieres generar un diseño vertical solo a partir de texto, establece settings.skill en webpage.
¿Puedo combinar refer_image y style_refer_image en una sola solicitud?
No. Los roles de referencia están estrictamente separados por modo: ecommerce solo acepta refer_image, mientras que webpage solo acepta style_refer_image y subject_refer_image. El Playground bloquea roles mezclados antes de enviar; en llamadas directas a la API, la solicitud puede reservar créditos y fallar luego de forma asíncrona durante el procesamiento, reembolsando automáticamente los créditos reservados.
¿La primera imagen de referencia cuenta en la facturación?
Sí. Cada imagen de referencia de entrada suministrada en contents se cobra una vez en una tarea completada, empezando desde la primera imagen. Las tareas fallidas sin resultado liberan automáticamente sus créditos reservados.
¿En qué se diferencia Kling Image 4.0 Long Image de Kling Image 4.0?
Kling Image 4.0 Long Image genera un único PNG largo continuo pensado para páginas verticales de detalle de ecommerce y diseños de páginas web. Kling Image 4.0 genera imágenes fijas con relación de aspecto estándar (hasta 9 opciones independientes o una serie de 2 a 10 tomas) en 2K o 4K.
¿Cómo debo gestionar las descargas de PNG verticales de 50 MB?
Configura tiempos de espera de descarga HTTP por encima de 60 segundos, transmite los bytes de respuesta directamente a almacenamiento de objetos o disco y verifica Content-Length o las dimensiones del PNG después de la descarga antes de ejecutar scripts de troceado de imágenes.
Lleva Kling Image 4.0 Long Image a producción
Empieza probando un prompt webpage en 1k dentro del área de pruebas de Kling Image 4.0 Long Image para verificar el ritmo de las secciones y el equilibrio visual. Una vez que el esquema vertical encaje con la estructura de tu tienda o campaña, fija las URL de referencia, sigue el esquema de la documentación de la API de Kling Image 4.0 Long Image y construye un pipeline repetible de consulta y troceado en torno a output.image_urls[0].
Referencias
- Kling AI, Kling Image 4.0 Long Image Generation API — especificaciones oficiales de los skills
ecommerceywebpage, guía de niveles de longitud y límites de referencias. - reAPI, Documentación de la API de Kling Image 4.0 Long Image — esquema de solicitud, restricciones HTTP(S) de referencias, límites ponderados de prompt, esquema de salida y mecánica de facturación.
- reAPI, Página del modelo Kling Image 4.0 Long Image y precios en vivo — tarifas actuales por nivel de salida y por referencia comprobadas el 20 de noviembre de 2026.
- reAPI, Referencia de la API de Tasks — consulta asíncrona de tareas, estados terminales y manejo de errores.