Introducción
Escribe un brief para toda la secuencia y recibe las imágenes en orden. Agrega hasta diez referencias cuando un personaje, una prenda o un producto deba aparecer de principio a fin.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Imagen |
| Editor | Kling |
| Fecha de lanzamiento | 17 de noviembre de 2026 |
| Imágenes por solicitud | 2–10; 4 por defecto |
| Longitud del prompt | 1–21,000 caracteres |
| Opciones de resolución | 2k (por defecto), 4k, 8k |
| Relaciones de aspecto de salida | auto por defecto; también 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 y 21:9 |
| Referencias compartidas | Opcionales; hasta 10 imágenes |
| Formatos de referencia | JPG o PNG |
| Tamaño del archivo de referencia | Hasta 30 MB por imagen |
| Dimensiones de referencia | Al menos 300 px por lado |
| Relación de aspecto de referencia | Entre 2:5 y 5:2 |
| Base de facturación | Por imagen entregada a la resolución seleccionada, más un cargo de entrada por cada referencia |
Funciones y aspectos destacados
Una rosa en el mismo estante con dos iluminaciones
Nuestra solicitud de dos imágenes usó una referencia de producto y pidió conservar el producto idéntico. La salida matutina muestra la misma rosa en el mismo estante de madera que la vista nocturna. Ambos archivos recibidos fueron PNG de 2048 × 2048 con la configuración 2k.
La luz cálida de una lámpara cambia la escena
La salida complementaria coloca la rosa y el estante de madera bajo una lámpara de mesa cálida. Proviene de la misma solicitud que la imagen de luz matutina tenue, con dos salidas y un lienzo cuadrado. Compare el par para ver cómo el cambio de iluminación solicitado convive con el sujeto y el estante conservados.
Dé una función definida a cada imagen
Escriba los requisitos compartidos una vez y luego describa las imágenes en secuencia. La solicitud acepta de dos a diez salidas, hasta diez referencias compartidas y una resolución de 2k, 4k u 8k. Cantidad, forma y resolución son decisiones separadas; ajuste cada una a la serie que desea revisar.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 21,000 caracteres. Indica las reglas de toda la serie y describe luego cada imagen en orden. mínimo 1 caracteres · máximo 21000 caracteres |
reference_image_urls | No | Opcional, hasta 10 imágenes compartidas por toda la serie. Los archivos deben ser JPG o PNG, de 30 MB como máximo, con 300 px o más por lado y proporción de 2:5 a 5:2. máximo 10 elementos |
num_outputs | No | Imágenes de la serie, de 2 a 10. El valor predeterminado es 4 y se cobra cada imagen entregada. |
resolution | No | Nivel de la serie: 2k, 4k u 8k. El valor predeterminado es 2k y los niveles mayores encarecen cada imagen. |
aspect_ratio | No | Forma de toda la serie: auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 o 21:9. El valor predeterminado es auto y esta opción no influye en el costo. |
Precios
Cada imagen entregada en la serie se cobra según la resolución elegida y cada imagen de referencia suma un pequeño cargo de entrada.
| Especificación | Precio |
|---|---|
| $0.063 / imagen |
| $0.094 / imagen |
| $0.157 / imagen |
Casos de uso
Estudios de iluminación de productos
Compare un producto bajo distintas condiciones de iluminación y pida que el objeto y su ubicación se mantengan fijos. Nuestra solicitud de la rosa produjo una vista matutina y otra con luz de lámpara al anochecer de la misma escena en un estante.
Paneles de procesos artesanales
Describa una tarea de taller en etapas numeradas y ajuste num_outputs a la secuencia prevista. Nombre las herramientas, los materiales y los detalles del espacio de trabajo que deben mantenerse en el panel.
Planificación de ángulos para catálogos
Asigne a cada imagen un ángulo diferente del producto, con una referencia compartida y una lista de detalles que deben conservarse. Compare los objetos recibidos con esa referencia antes de elegir material para el catálogo.
Estudios de composición para campañas
Use un sujeto y una paleta comunes en toda la serie y dé a cada imagen una composición distinta. Elija una relación compatible con el espacio de publicación previsto y revise la continuidad visual del conjunto.
Guía de prompts y consejos prácticos
Defina el tema compartido
Describa el producto, lugar o sujeto profesional que conecta la serie. Indique los detalles que desea conservar antes de enumerar las imágenes individuales.
Asigne una función a cada imagen
Numere las imágenes en el orden que necesita y describa una vista o un momento por imagen. Establezca
num_outputsen esa cantidad, entre dos y diez.Asocie las referencias y configure el lienzo
Agregue referencias compartidas cuando necesite un punto de apoyo visual y cítelas como @
image_1y @image_2. Seleccione la resolución y la relación de aspecto de la serie.Revise la secuencia completa
Compare los detalles del sujeto y la composición en todas las imágenes recibidas. El ejemplo de la rosa presenta un estudio de iluminación de dos imágenes que puede examinar antes de escribir su propia descripción.
Construya una secuencia alrededor de un sujeto compartido
El endpoint Kling Image 4.0 Set acepta una descripción para dos a diez imágenes relacionadas. Describa la serie en conjunto y luego asigne a cada imagen una posición y una función visual. Las imágenes de referencia opcionales se aplican a toda la solicitud, por lo que una foto de producto puede servir como punto de apoyo para un estudio de iluminación o un conjunto de ángulos de vista.
La continuidad es el aspecto que debe planificar: decida qué detalles deben seguir siendo reconocibles y cuáles deben cambiar. Para un estudio de iluminación, indique el objeto y su ubicación como detalles fijos y asigne una fuente de luz diferente a cada imagen. Para una secuencia de proceso, defina el espacio de trabajo una vez y describa la tarea en cada etapa.
Parámetros de la solicitud
Estos son los campos públicos del endpoint. Haga coincidir la cantidad de imágenes solicitadas con las descripciones numeradas del prompt.
| Campo | Obligatorio | Opciones y límites | Función |
|---|---|---|---|
prompt | Sí | 1–21,000 caracteres | Describa la serie, las imágenes en orden y los detalles que deben conservarse. Cite referencias como @image_1, @image_2. |
reference_image_urls | No | Hasta 10 archivos JPG o PNG | Referencias visuales compartidas. Cada archivo puede pesar hasta 30 MB, debe medir al menos 300 px por lado y tener una relación entre 2:5 y 5:2. |
num_outputs | No | 2–10; 4 por defecto | Cantidad de imágenes relacionadas solicitadas. |
resolution | No | 2k, 4k, 8k; 2k por defecto | Nivel de resolución que determina la tarifa por imagen. |
aspect_ratio | No | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9; auto por defecto | Forma de la serie; auto elige según el prompt y las referencias. |
Cuente las imágenes y las referencias por separado
Una referencia aporta información visual; no establece la cantidad de imágenes de la serie. La solicitud de la rosa usó una referencia con num_outputs establecido en dos. Elija la cantidad de forma deliberada en lugar de asumir que depende del número de archivos cargados.
Presupueste la serie entregada
Use el precio que muestra esta página para la resolución seleccionada. Cada imagen entregada se cobra con esa tarifa y cada referencia añade un pequeño cargo de entrada. Por lo tanto, una serie se factura por las imágenes entregadas más las referencias de entrada, en lugar de como una imagen individual. Revise juntos la cantidad de salidas, la resolución y el número de referencias antes de enviar la solicitud.
Escriba una descripción con detalles fijos y cambios previstos
Comience con el sujeto, el entorno y el tratamiento visual compartidos. Continúe con descripciones numeradas de imágenes y una instrucción clara de conservación. Dedique el prompt a detalles que se puedan verificar, como las proporciones del producto, la ubicación en el estante, la vista de cámara y la iluminación.
Asigne una tarea visual a cada imagen
En una serie de producto, una imagen puede presentar el objeto y otra examinarlo con una luz diferente. En un proceso de taller, cada imagen puede representar una etapa definida. Describa qué distingue a cada imagen para que la solicitud tenga una progresión útil.
Dé una función concreta a las referencias
Identifique el producto de @image_1 o el entorno de @image_2 y luego indique qué debe conservar la serie de cada referencia. Asegúrese de que esos números coincidan con el orden de entrada.
Elija la forma y la resolución de manera deliberada
La serie comparte una configuración de relación de aspecto y un nivel de resolución. Si necesita un diseño cuadrado, elija 1:1 en lugar de dejar la forma en auto. La ejecución de la rosa seleccionó 1:1 y 2k. Revise la composición y los detalles conservados del sujeto antes de decidir si otro nivel es apropiado para su trabajo.
Qué devolvió la solicitud de la rosa
El 18 de noviembre de 2026 enviamos un prompt que pedía el producto de referencia en un estante de madera bajo dos condiciones de iluminación. La configuración fue una referencia, dos salidas, resolución 2k y relación de aspecto 1:1. La solicitud devolvió dos PNG de 2048 × 2048.
Mañana y noche a partir de la misma descripción
La imagen matutina muestra la rosa en el estante de madera con luz tenue. Su compañera muestra la misma rosa en el mismo estante bajo una lámpara de mesa cálida. Ambas vistas provienen de la misma solicitud. Compare las dos imágenes juntas al evaluar el objetivo de conservación y el cambio de iluminación pedido.
Revise el conjunto antes de seleccionar imágenes
Coloque juntas las imágenes recibidas y compárelas con los requisitos compartidos del prompt. En un estudio de producto, examine las proporciones y la posición del objeto, además de los cambios de iluminación previstos. En un panel de proceso, compruebe que esté presente cada etapa solicitada y que los detalles del espacio de trabajo conecten la secuencia. Si necesita revisar una vista, haga más específica su descripción y mantenga claras las instrucciones compartidas.
Límites y opciones relacionadas
La cantidad de imágenes debe mantenerse entre dos y diez, y el prompt no debe superar 21,000 caracteres. Compruebe que cada referencia cumpla los requisitos de archivo, dimensiones y relación de aspecto de la tabla. La generación de series también requiere una revisión visual: compare los detalles del producto y los cambios previstos en todas las imágenes recibidas antes de usarlas en un catálogo o una campaña.
Para una imagen independiente, compare Kling Image 4.0. Para una composición de página continua, considere Kling Image 4.0 Long: Kling indica que su modo de imagen larga produce una imagen de página completa. Elija según si su entrega necesita imágenes separadas o un diseño de página continuo.
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-set/text-to-image",
"input": {
"aspect_ratio": "auto",
"num_outputs": 4,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.













