Introducción
Sube de una a diez imágenes, cítalas por número en la instrucción y describe el cambio. Úsala para cambiar el estilo de una foto, mover un sujeto a otro lugar o combinar personas, prendas y productos.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Publicación | Kling |
| Fecha de lanzamiento | 17 de noviembre de 2026 |
| Tareas | Texto a imagen; edición de imágenes |
| Longitud del prompt | De 1 a 21,000 caracteres |
| Resoluciones | 2k (predeterminada), 4k, 8k |
| Resultados independientes | De 1 a 9 por solicitud; 1 de forma predeterminada |
| Relaciones de salida | auto (predeterminada), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 |
| Referencias de edición | De 1 a 10 imágenes, citadas en orden de carga |
| Formatos de referencia | JPG o PNG |
| Tamaño de referencia | Hasta 30 MB por imagen |
| Dimensiones de referencia | Al menos 300 px por lado; relación entre 2:5 y 5:2 |
| Facturación | Por imagen entregada según resolución; la edición también cobra por referencia |
Funciones y aspectos destacados
Un título correcto con texto adicional por revisar
SLOW STEEP colocó el título solicitado sobre una tetera índigo grabada en papel crema. También inventó líneas de apoyo. Este resultado en 2k muestra por qué la instrucción debe definir las palabras permitidas y el límite para texto adicional.
Barcos y neblina al amanecer en 4k
El prompt del puerto nombraba barcos pesqueros de madera, neblina y luz dorada tenue. La escena ancha llegó como PNG de 5440 x 3072 en 4k. Revisa los barcos y la luz suave del ejemplo al planear una imagen editorial.
Un helecho de 8192 píxeles
La prueba botánica devolvió un PNG de 8192 x 8192 con líneas finas de tinta y acuarela verde apagada sobre papel blanco roto. Examina la composición cuadrada y la combinación de contornos dibujados con acuarela.
Una rosa repintada sobre ámbar
La edición mantuvo reconocible la rosa y cambió su tratamiento a un anuncio antiguo pintado a mano. También introdujo ROSE y NATURAL ESSENCE sin que se pidieran. Revisa el texto agregado con el mismo cuidado que la conservación del sujeto.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 21,000 caracteres. Cita los archivos como @ |
image_urls | Sí | De una a diez imágenes de referencia, numeradas según el orden de carga. Usa archivos JPG o PNG de hasta 30 MB, con al menos 300 px por lado y proporción de 2:5 a 5:2. mínimo 1 elementos · máximo 10 elementos |
num_outputs | No | Resultados independientes que se devuelven, de 1 a 9. El valor predeterminado es 1 y se cobra cada imagen entregada. |
resolution | No | Nivel de salida: 2k, 4k u 8k, con 2k como valor predeterminado. Los niveles superiores cuestan más por imagen. |
aspect_ratio | No | Forma del resultado: auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 o 21:9. El valor predeterminado auto sigue el prompt y las referencias. |
Precios
Cada imagen entregada 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
Carteles para festivales de té
Indica el título del evento entre comillas, el color del papel y una ilustración central. Nuestro cartel SLOW STEEP en 2k escribió bien el título sobre una tetera índigo, pero agregó líneas de apoyo que requieren revisión antes de entregar.
Puertos para composiciones editoriales
Describe objetos visibles y luz, y elige un encuadre ancho para la ubicación prevista. La prueba de puerto en 4k devolvió un PNG de 5440 x 3072 con barcos pesqueros de madera, neblina y luz tenue del amanecer.
Ilustración botánica para formatos grandes
Especifica planta, papel, trazos y color antes de elegir resolución. El helecho cuadrado en 8k llegó como PNG de 8192 x 8192, con tinta y acuarela verde apagada sobre papel blanco roto.
Conceptos publicitarios con referencias
Lleva una foto del producto a edición y describe el tratamiento nuevo. En nuestra rosa, el sujeto siguió reconocible sobre fondo ámbar, pero los textos agregados ROSE y NATURAL ESSENCE requirieron revisión.
Guía de prompts y consejos prácticos
Elige el material de partida
Usa texto a imagen para describir una escena, o edición cuando una imagen existente aporte el sujeto o la dirección visual.
Describe la escena o el cambio
Indica sujeto, entorno, iluminación y texto exacto. Para editar, asigna las fuentes por orden de carga con @
image_1y @image_2, y explica qué debe cambiar y qué debe conservarse.Define el encuadre y la cantidad
Selecciona 2k, 4k u 8k y una relación de aspecto compatible, o deja auto. Solicita de una a nueve imágenes independientes y consulta el precio mostrado para la resolución y las referencias elegidas.
Revisa el texto y los detalles
Compara las letras con tu texto y los objetos editados con sus referencias. El cartel de té y el anuncio de la rosa agregaron palabras no solicitadas. Incluye «ninguna otra palabra» si necesitas una composición estricta y revisa el resultado.
Edita una imagen con un cambio definido
Trae imágenes existentes cuando el sujeto o el tratamiento de origen importen para el siguiente diseño. La edición de Kling Image 4.0 acepta un prompt y de una a diez referencias. La instrucción explica la función de cada una, el cambio solicitado y los detalles que deben seguir reconocibles.
Nuestra rosa pasó a ser un anuncio antiguo pintado a mano sobre fondo ámbar. Siguió reconocible, pero apareció texto no deseado. Revisa sujeto y diseño completo antes de seleccionar una imagen para entregar.
Prepara referencias y controles
Verifica formatos y orden de carga antes de escribir citas numeradas. Mantén cada referencia asociada con su función para que números e instrucciones coincidan.
Tabla de parámetros
El prompt y las referencias son obligatorios. Cantidad, resolución y relación son opcionales con estos valores predeterminados.
| Parámetro | Entrada aceptada | Valor predeterminado | Uso |
|---|---|---|---|
prompt | Cadena obligatoria, de 1 a 21,000 caracteres | Ninguno | Cita referencias y separa cambios de conservación. |
image_urls | Arreglo obligatorio de 1 a 10 imágenes | Ninguno | Entrega JPG o PNG en el orden citado. |
num_outputs | Entero de 1 a 9 | 1 | Solicita ediciones independientes. |
resolution | 2k, 4k, 8k | 2k | Selecciona el nivel usado para el precio. |
aspect_ratio | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | auto | Fija la forma o sigue prompt y referencias. |
Cada referencia puede ocupar hasta 30 MB, debe medir al menos 300 px por lado y tener una relación entre 2:5 y 5:2. Son requisitos de entrada. Selecciona por separado el encuadre de salida, sin suponer que lo definen las dimensiones originales.
Asigna responsabilidades en la instrucción
Aclara la función de cada fuente antes de describir el acabado. Por ejemplo, pide el objeto cerámico de @image_1 y la paleta de @image_2. Después define fondo y tratamiento, distinguiendo detalles a conservar y cambios.
Alinea las citas con el orden de entrada
Usa @image_1 para el inicio del arreglo y @image_2 para la siguiente imagen. Asocia cada cita con sujeto, paleta o tratamiento. Si el cambio contradice un detalle de origen, indica qué parte deseas modificar para aclarar la dirección.
Describe qué conservar con detalles concretos
Nombra rasgos visibles como la forma del asa, el contorno de una flor o las marcas de un producto. Luego especifica superficie pintada, otro fondo o una disposición nueva. Compara la salida con el original; una instrucción de conservación no sustituye esa revisión.
Controla el texto incluso al cambiar de estilo
«Anuncio antiguo» describe un género, pero deja espacio para inventar palabras. Indica el texto exacto o pide que no haya letras. Añade «ninguna otra palabra» para limitar el texto y revisa el resultado. La rosa muestra por qué las letras merecen atención incluso en cambios de estilo visual.
Resultado observado: rosa sobre ámbar
amber-rose-vintage-ad usó una referencia, 2k, relación 2:3 y una salida. Devolvió un PNG de 1664 x 2496. La rosa permaneció reconocible y se repintó sobre ámbar según el tratamiento manual solicitado.
Palabras que aparecieron sin solicitarlas
La misma salida incluyó ROSE y NATURAL ESSENCE. Ninguna frase estaba en la instrucción. Trátalo como un defecto que revisar antes de entregar publicidad, aunque se haya conservado el sujeto. Compara cada palabra con tu texto, incluidas las líneas pequeñas alrededor del motivo principal.
Entiende el cargo antes de agregar fuentes
Consulta el precio mostrado para la resolución elegida. Cada imagen entregada se cobra a ese nivel y cada referencia agrega un pequeño cargo de entrada. Alinea las fuentes con la edición para evaluar su utilidad y su costo de entrada. Aumentar la cantidad también aumenta las imágenes por revisar.
Elige el flujo según la entrega
Usa texto a imagen si no necesitas una fuente. Reserva la edición para cuando la entrada aporte sujeto o dirección visual. En una revisión, identifica el detalle que requiere atención y describe el cambio junto con los rasgos que conservarás. Compara cada resultado con las fuentes antes de elegirlo.
Según Kling, las series planean imágenes relacionadas y las imágenes largas crean una composición completa de detalle de producto o página web. Elige Kling Image 4.0 Set (kling/image-4.0-set) para colecciones o Kling Image 4.0 Long (kling/image-4.0-long) para páginas largas. De una a nueve ediciones independientes no forman una serie coordinada. Para comparar con otro modelo, usa las mismas fuentes y solicitud de cambio, y examina juntos sujeto conservado, fondo y texto agregado.
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/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"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.















