Introducción
Sube las fotos de tu producto, enumera los argumentos de venta y recibe una página de detalle terminada. Elige la extensión de la página y la resolución adecuada para tu tienda.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Editor | Kling |
| Fecha de lanzamiento | 17 de noviembre de 2026 |
| Tareas de página | Diseño de página web; ficha de producto de comercio electrónico |
| Extensión del prompt | De 1 a 71,000 caracteres para ambas tareas |
| Niveles de resolución | 1k (predeterminado), 2k |
| Longitud de ficha de producto | short, medium (predeterminado), long |
| Referencias de página web | De 0 a 3 imágenes |
| Fotos de producto requeridas | De 1 a 3 imágenes |
| Requisitos de imagen de entrada | JPG o PNG; hasta 30 MB; al menos 300 px por lado; relación de 2:5 a 5:2 |
| Resultado web registrado | PNG de 2048 x 16469 en 2k |
| Resultado de producto registrado | PNG de 1024 x 5021 con longitud short y 1k |
Funciones y aspectos destacados
Un brief de cerámica convertido en una página completa
La solicitud de Tideline Ceramics especificó el título principal, los cuencos, la historia del taller y el pie de página. El PNG 2k recibido midió 2048 x 16469 e incluyó esas secciones. Revisa los textos pequeños antes de reutilizar una página de esta altura.
Un diseño corto basado en una foto de rosa
Nuestra solicitud de rosa preservada usó una imagen proporcionada, longitud short y resolución 1k. Devolvió un PNG de 1024 x 5021 dispuesto como ficha de producto alrededor de esa foto.
Dale a cada sección una función y sus palabras
Ambos endpoints aceptan prompts de hasta 71,000 caracteres. Usa ese espacio para el orden de lectura, los textos aportados y las funciones de las referencias. Las referencias web son opcionales; una ficha requiere de una a tres fotos del producto.
Separa longitud y resolución
Ambas tareas ofrecen 1k y 2k, con 1k predeterminado. Las fichas añaden un selector short, medium o long. Estas elecciones afectan el precio de la página, y cada imagen tiene un pequeño cargo de entrada.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 71,000 caracteres. Incluye datos del producto, argumentos de venta y el orden de los módulos, citando las fotos como @ |
image_urls | Sí | Se requieren de una a tres fotos de producto. Usa archivos JPG o PNG de 30 MB o menos, con al menos 300 px por lado y proporción de 2:5 a 5:2. mínimo 1 elementos · máximo 3 elementos |
page_length | No | Extensión de la página: short, medium o long. El valor predeterminado es medium y las páginas más largas cuestan más. |
resolution | No | Nivel de la página: 1k o 2k, con 1k como valor predeterminado. El nivel 2k cuesta más en todas las extensiones. |
Precios
Cada página terminada se cobra según su extensión y resolución, y cada foto de producto suma un pequeño cargo de entrada.
| Resolución | Page length: short | Page length: medium | Page length: long |
|---|---|---|---|
| $0.235 / imagen | $0.47 / imagen | $0.784 / imagen |
| $0.282 / imagen | $0.549 / imagen | $0.862 / imagen |
Casos de uso
Conceptos web para un taller de cerámica
Define una sección principal, una selección de cuencos, la historia del taller y sus horarios. Nuestra ejecución de Tideline Ceramics devolvió esas secciones en un PNG de 2048 x 16469; los textos pequeños requieren revisión antes de reutilizarlos.
Fichas para productos de regalo
Parte de una foto y solicita una sección principal, argumentos de venta, instrucciones de cuidado y un panel de mensaje de regalo. La ejecución corta de la rosa preservada devolvió un PNG de 1024 x 5021 organizado alrededor de la foto proporcionada.
Dirección de marca para entregar un diseño
Usa referencias web opcionales para comunicar una paleta o un tema, e indica el público y el orden de las secciones en el prompt. Revisa la imagen con el equipo antes de desarrollar el sitio.
Briefs comerciales según la longitud
Organiza la información verificada del producto en módulos y elige short, medium o long. Ajusta la cantidad de texto a esa selección y comprueba si la página generada omite o altera datos.
Guía de prompts y consejos prácticos
Elige el endpoint según tu brief
Usa diseño web para un sitio descrito con texto y referencias opcionales. Elige el endpoint de ficha de producto cuando tengas fotos del artículo y argumentos de venta verificados.
Describe el recorrido de arriba hacia abajo
Ordena los módulos según la lectura y cita el título, el cuerpo y las etiquetas de los botones de cada uno. Explica qué aporta cada referencia numerada y cómo debe utilizarse.
Selecciona los ajustes de página
Elige resolución 1k o 2k en ambos endpoints. Para una ficha de producto, selecciona también short, medium o long; medium es el valor predeterminado.
Revisa la página descargada
Lee la imagen a un tamaño útil y compara sus textos y afirmaciones sobre el producto con el brief. Revisa la continuidad entre módulos antes de entregar el diseño o preparar una imagen para la publicación.
Construye una historia de producto con las fotos proporcionadas
Este endpoint combina fotografía de producto y un brief comercial para componer una imagen continua de ficha. Úsalo cuando el comprador deba ver el artículo, entender los argumentos aportados y seguir la información por una secuencia de módulos. Incluye los datos del producto junto con las fotos; el brief debe definir lo que se pide comunicar a la página.
A diferencia del diseño web, esta tarea exige fotos de producto y ofrece un control de longitud. El resultado es una imagen plana para revisión o preparación de una publicación. No incluye una tienda editable ni archivos separados de módulos.
Entradas de producto y controles de página
Prepara las imágenes y el texto verificado antes de elegir longitud y resolución. Ambos ajustes afectan el precio de página, y las fotos cargadas generan cargos de entrada.
| Parámetro | Requisito | Propósito |
|---|---|---|
prompt | Texto obligatorio, de 1 a 71,000 caracteres | Aporta datos, argumentos y orden de módulos; cita fotos con @image_1, @image_2. |
image_urls | Arreglo obligatorio de 1 a 3 fotos | Usa JPG o PNG de hasta 30 MB, al menos 300 px por lado y relación entre 2:5 y 5:2. |
page_length | Opcional: short, medium o long; predeterminado medium | Selecciona la longitud de la ficha. |
resolution | Opcional: 1k o 2k; predeterminado 1k | Elige el nivel de salida con independencia de la longitud. |
Ajusta la longitud a la cantidad de información del producto que quieras presentar. Selecciona la resolución por separado y revisa la imagen pensando en su ubicación prevista en la tienda.
Elige fotos por la información que aportan
Muestra claramente el producto y explica la contribución de cada imagen numerada, como una vista general o un detalle cercano. Distingue lo visible en la foto de las especificaciones aportadas como texto. Indica qué vista debe presentar el artículo y cuál apoyará un módulo de detalle, de modo que cada foto quede vinculada a una parte clara de la página.
Arma el brief comercial
Comienza con la identidad del producto y los datos verificados. Después enumera los módulos según el recorrido del comprador: sección principal, argumentos proporcionados, detalles de apoyo y panel final. Incluye instrucciones de cuidado cuando tengas textos comprobados. No solicites al modelo inventar dimensiones, materiales o afirmaciones para llenar una sección vacía.
Escribe textos que se puedan comprobar
Cita el título y el texto de cada bloque junto a su sección prevista. Si falta un dato, omítelo del texto solicitado. Una lista de adjetivos generales ofrece poco que verificar; una afirmación aportada sobre una característica se puede comparar directamente con la imagen. Expresa con claridad datos, dirección visual y orden de módulos en el brief.
Ajusta el volumen de contenido a la longitud
Selecciona short, medium o long y escribe un brief acorde con ese alcance. Una página compacta puede centrarse en una presentación breve; un brief más largo puede reservar espacio para información adicional proporcionada. Asigna una función distinta a cada módulo y elimina argumentos repetidos antes de enviar el prompt. Cambiar la resolución es otra decisión y no sustituye reducir un texto saturado.
Observaciones de la ejecución de rosa preservada
Nuestra solicitud del 18 de noviembre de 2026 incluyó una foto de rosa y pidió una imagen principal, tres argumentos de venta, cuidados y un panel final de mensaje de regalo con paleta ámbar y marfil. Los controles seleccionaron short y 1k. El brief conectó la foto con una secuencia de presentación, cuidado y regalo.
La respuesta incluyó un PNG de 1024 x 5021 como ficha corta alrededor de la foto. Comprueba el aspecto del producto durante el recorrido y compara argumentos, cuidados y mensaje final con el texto aportado antes de preparar la página para los compradores.
Cargos y revisión antes de publicar
Revisa el precio actual mostrado aquí para la longitud y resolución elegidas. Cada ficha terminada se cobra según esas dos opciones y cada foto suma un pequeño cargo de entrada. Incluye todas las fotos al calcular ese cargo; que sean necesarias no las convierte en adjuntos sin costo.
Antes de preparar la imagen para la tienda, compara el artículo representado con las fotos y coteja cada afirmación, número e instrucción de cuidado con la ficha de datos. Revisa espaciado y orden de lectura al tamaño previsto. El resultado es una imagen de página, por lo que las modificaciones posteriores de diseño o texto requieren un flujo de edición de imágenes o diseño.
Cuándo conviene otra familia para el resultado
Kling indica que el flujo estándar está pensado para piezas individuales y el de series para imágenes separadas coordinadas. Compara Kling Image 4.0 para una imagen de producto individual, o Kling Image 4.0 Set para una colección separada. Mantén este endpoint cuando necesites una ficha continua de producto basada en tus fotos.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/image-4.0-long/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"page_length": "medium",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.













