Introducción
Describe una escena, un póster o un personaje y recibe imágenes terminadas. En cada solicitud eliges la resolución, el formato y cuántas versiones independientes quieres.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| 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. Indica el sujeto, la acción, el lugar, la cámara y la luz, y pon entre comillas las palabras que deban aparecer. mínimo 1 caracteres · máximo 21000 caracteres |
num_outputs | No | Cantidad de versiones independientes, de 1 a 9. El valor predeterminado es 1 y se cobra cada imagen entregada. |
resolution | No | Nivel de salida: 2k, 4k u 8k. El valor predeterminado es 2k y un nivel superior cuesta más por imagen. |
aspect_ratio | No | Forma de la imagen: auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 o 21:9. El valor predeterminado auto deja la decisión al modelo. |
Precios
Cada imagen entregada se cobra según la resolución elegida. La proporción no cambia el precio.
| 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.
Convierte instrucciones escritas en una imagen fija
Usa este endpoint cuando puedas describir la escena sin cargar una imagen fuente. Kling Image 4.0 requiere un prompt y ofrece 2k, 4k y 8k, con una a nueve imágenes independientes por solicitud. Probamos un cartel de festival de té, un puerto al amanecer y un helecho en tinta y acuarela.
Un lote ofrece alternativas independientes de la misma instrucción. Elige una cantidad manejable para revisar y usa la familia Set relacionada si necesitas una colección coordinada.
Controles de la solicitud
El prompt es obligatorio. Los demás controles fijan cantidad, resolución y forma; si los omites se aplican estos valores.
| Parámetro | Entrada aceptada | Valor predeterminado | Función |
|---|---|---|---|
prompt | Cadena obligatoria, de 1 a 21,000 caracteres | Ninguno | Describe sujeto, entorno, luz y palabras exactas. |
num_outputs | Entero de 1 a 9 | 1 | Solicita imágenes independientes de la misma instrucción. |
resolution | 2k, 4k, 8k | 2k | Elige resolución y precio de imagen asociado. |
aspect_ratio | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | auto | Fija el encuadre o deja que el modelo interprete la instrucción. |
Elige resolución según la entrega y relación según la ubicación. Comprueba las dimensiones del archivo al preparar la composición; los ejemplos siguientes muestran los tamaños recibidos.
Dale una composición para dibujar
Empieza por un sujeto visible y su entorno; luego define luz y tratamiento. El puerto menciona barcos de madera, neblina del amanecer y luz dorada tenue. El helecho menciona planta, papel blanco roto, tinta fina y acuarela verde apagada. Describe lo visible en lugar de recurrir a elogios generales de calidad.
Separa las instrucciones de texto
En un cartel, cita el título y ubícalo en el encuadre. Separa las palabras requeridas de la dirección de la ilustración y agrega «ninguna otra palabra» si el texto adicional sería un problema. Revisa toda la imagen, incluidas las líneas pequeñas que no solicitaste.
Kling indica que una imagen puede contener hasta 2,000 caracteres de texto generado. Distingue ese límite de los 21,000 caracteres del prompt: uno corresponde a las letras dibujadas y otro a la descripción completa. Agrupa título y líneas de apoyo por posición para mantener legibles las instrucciones.
Ajusta escena y encuadre
Elige una relación fija cuando conozcas la ubicación: un cartel vertical y una escena editorial ancha necesitan encuadres distintos. Usa auto si prefieres que el prompt guíe la forma. Si cambias la resolución después de revisar un borrador, inspecciona de nuevo; no des por hecho que se conservaron composición y texto.
Resultados de las pruebas del 18 de noviembre
Las tres pruebas usaron sujetos, resoluciones y formas diferentes. Revisa composición, superficies y texto al planear tu imagen.
Cartel de té en 2k
SLOW STEEP usó 3:4 y devolvió un PNG de 1760 x 2336. El título quedó correcto sobre una tetera índigo grabada en papel crema. También se inventaron líneas de apoyo. Revisa esas líneas y el encabezado antes de usar el cartel.
Puerto en 4k
La solicitud del amanecer usó 16:9 y devolvió un PNG de 5440 x 3072 con barcos de madera, neblina y luz tenue. El formato ancho deja espacio a barcos, neblina y puerto circundante.
Helecho en 8k
La solicitud botánica cuadrada devolvió un PNG de 8192 x 8192 de un helecho en tinta y acuarela sobre papel blanco roto. Kling describe 8k como generación nativa. Examina trazos finos, color y encuadre cuadrado en el ejemplo.
Decisiones de precio y revisión
Consulta el precio mostrado para la resolución seleccionada. Cada imagen entregada se cobra a ese nivel; más salidas independientes implican más imágenes por pagar y revisar. Elegir otra relación de aspecto no modifica la tarifa de generación de imágenes. Evalúa la composición en un nivel antes de decidir si conviene otra resolución u otro lote.
Alcance y familias relacionadas
Este endpoint acepta texto en lugar de una imagen fuente. Usa edición de imágenes en esta página si un objeto o fotografía existente debe guiar el resultado.
Kling indica que la generación en serie coordina imágenes relacionadas y la generación larga crea visuales de detalle de producto o páginas web. Elige Kling Image 4.0 Set (kling/image-4.0-set) para una colección coordinada, o Kling Image 4.0 Long (kling/image-4.0-long) para una entrega con forma de página. Los controles independientes de aquí responden a otra estructura de salida. Compara candidatos con la misma composición, texto exacto y requisitos de entrega, al tamaño de uso previsto.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "auto"
}
}'
# 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.















