
La Kling Image 4.0 API (kling-4.0-image) es la sucesora de la Kling O3 Image API (kling-o3-image y kling-o3-image-edit) en PoYo. En resumen: Kling Image 4.0 añade 8K, series de imágenes, un prompt de 50,000 caracteres y un modelo aparte para páginas largas, y cuesta aproximadamente entre tres y cuatro veces más por imagen. Este artículo compara ambos petición por petición para que decidas qué llamadas migrar. Los dos están en PoYo: Kling Image 4.0 y Kling O3 Image.
La decisión en una tabla
| Si tu petición necesita… | Llama a |
|---|---|
| Salida en 1K, o el precio más bajo por imagen | kling-o3-image / kling-o3-image-edit |
| JPEG o WebP directamente desde la API | Kling O3 Image (output_format) |
| Más de 4K, o exactamente 8K | kling-4.0-image |
| Una serie de 2–10 imágenes con el mismo sujeto y estilo | kling-4.0-image con enable_sequential |
| Prompts de más de 2,000 caracteres | kling-4.0-image (hasta 50,000) |
| Una página web completa o una página de detalle de ecommerce como una sola imagen | kling-4.0-long-image |
| Texto a imagen y edición con un solo ID de modelo | kling-4.0-image |
Diferencias de la petición campo a campo
Ambos usan POST https://api.poyo.ai/api/generate/submit, el mismo endpoint de estado y el mismo callback_url. Las diferencias están en model e input, según la documentación de PoYo de cada modelo.
| Campo | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
model | kling-o3-image (texto a imagen), kling-o3-image-edit (edición) | kling-4.0-image para ambos; image_urls activa el modo edición |
prompt | hasta 2,000 caracteres | 1–50,000 caracteres |
image_urls | 1–10, obligatorio para kling-o3-image-edit | 1–10 (opcional); 30 MB, ≥300 px, relación 0.4–2.5 cada una |
| Elementos | elements: [{frontal_image_url, reference_image_urls}] | kling_elements: [{element_input_urls: [front, …]}], 2–4 vistas, hasta 7, imágenes + elementos ≤ 10 |
resolution | 1K (por defecto), 2K, 4K | 2K (por defecto), 4K, 8K |
size | 8 relaciones, por defecto 16:9; auto solo en el modelo de edición | las mismas 8 relaciones más auto, por defecto auto |
output_format | jpeg, png (por defecto), webp | no se acepta; solo PNG |
n | 1–9 | 1–9 independientes, o 2–10 con enable_sequential: true |
enable_sequential | no disponible | true devuelve una serie ordenada y coherente |
| Páginas largas | no disponible | modelo aparte kling-4.0-long-image |
Kling describe Kling Image 4.0 en su publicación de lanzamiento como su primer modelo con generación nativa en 8K, capaz de planificar hasta 10 imágenes a partir de un prompt y de renderizar hasta 2,000 caracteres de texto en siete idiomas. Esas son afirmaciones de Kling; las diferencias de API de arriba son lo que cambia en tu código.
Precio para la misma petición
Precios de PoYo, 1 crédito = $0.005. Kling O3 Image no tiene recargo por referencia en PoYo; la Kling Image 4.0 API añade 1 crédito por imagen de referencia o elemento, una vez por petición. La propia página de precios de Kling señala el mismo cambio: Kling Image 4.0 cobra las entradas de referencia y los modelos anteriores no.
| Misma petición | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
| 1 imagen, 1K | 3.5 créditos ($0.0175) | no disponible (mínimo 2K: 13 créditos) |
| 1 imagen, 2K | 3.5 créditos ($0.0175) | 13 créditos ($0.065) |
| 1 imagen, 4K | 7 créditos ($0.035) | 19 créditos ($0.095) |
| 1 imagen, 8K | no disponible | 32 créditos ($0.16) |
| Edición 2K, 2 imágenes de referencia + 1 elemento | 3.5 créditos ($0.0175) | 16 créditos ($0.08) |
| 4 imágenes en 2K | 14 créditos ($0.07), independientes | 52 créditos ($0.26), como serie o independientes |
| Diseño de página web, 1K | no disponible | 110 créditos ($0.55) |
En 2K la Kling Image 4.0 API cuesta unas 3.7× más que Kling O3 Image por imagen, y unas 2.7× en 4K. Las tablas completas de Kling Image 4.0 están en precios de la Kling Image 4.0 API.
Límites que cambian
- Sube el mínimo de resolución. 1K desaparece; la salida más pequeña de Kling Image 4.0 es 2K. Si sirves miniaturas, mantenlas en O3 o redimensiona en tu lado.
- El máximo sube a 8K. La documentación de PoYo indica 8192×8192 en 1:1. En nuestra prueba del día del lanzamiento (API de producción de PoYo, 19 de noviembre de 2026), una petición 16:9 en 8K devolvió un PNG de 10880×6144 de unos 128 MB y tardó unos 3.8 minutos, a 32 créditos.
- Gestión de archivos. Sin
output_format: recibes PNG. Nuestras descargas fueron PNG RGBA incluso para imágenes opacas. Planifica la conversión y el almacenamiento si usabasjpegowebpen O3. - Las reglas de referencia son explícitas. Kling Image 4.0 valida cada referencia: hasta 30 MB, al menos 300 px por lado, relación ancho/alto entre 0.4 y 2.5. La documentación de O3 no indica esos límites, así que valida las imágenes muy anchas o pequeñas antes de migrar.
- Las series tardan más. Nuestra serie de cuatro imágenes en 2K tardó unos 4.9 minutos. Pasa los trabajos largos o grandes a
callback_url.
Cuándo cambiar
Pasa una llamada a kling-4.0-image cuando necesite algo que O3 no puede hacer: 8K, una serie coherente, un prompt largo o un diseño de página. Por ejemplo:
- Storyboards y ángulos de producto. En O3 enviarías
n: 4y esperarías que el sujeto coincidiera. Conenable_sequential: trueel modelo planifica la serie; nuestra prueba mantuvo el mismo piloto, moto y atuendo a lo largo del amanecer, el mediodía, el atardecer y la noche. - Impresión y recursos con muchos recortes. Todo lo que pase de 4K.
- Prompts largos y estructurados. Guías de marca, listas de planos y bloques de texto de más de 2,000 caracteres.
- Páginas de ecommerce.
kling-4.0-long-imagecrea la página de detalle completa; O3 no tiene equivalente.
Mantén O3 para borradores de 1K–2K en gran volumen, miniaturas y pipelines que necesitan JPEG o WebP desde la API. Usar ambos no es problema: O3 para explorar y Kling Image 4.0 para la serie final, con la misma clave.
Diff de migración
Una llamada de texto a imagen:
{
- "model": "kling-o3-image",
+ "model": "kling-4.0-image",
"input": {
"prompt": "A cinematic futuristic alley with rain and neon reflections",
"resolution": "4K",
"size": "16:9",
- "output_format": "png",
"n": 2
}
}
Una edición con un elemento. Dos campos renombrados y una fusión de IDs de modelo:
{
- "model": "kling-o3-image-edit",
+ "model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
- "elements": [
- {
- "frontal_image_url": "https://example.com/character-front.png",
- "reference_image_urls": ["https://example.com/character-side.png"]
- }
- ],
+ "kling_elements": [
+ {
+ "element_input_urls": [
+ "https://example.com/character-front.png",
+ "https://example.com/character-side.png"
+ ]
+ }
+ ],
- "resolution": "1K",
- "size": "auto",
- "output_format": "png"
+ "resolution": "2K",
+ "size": "auto"
}
}
Lista de comprobación:
- Sustituye los dos IDs de modelo de O3 por
kling-4.0-image; el modo edición se deduce ahora deimage_urls. - Renombra
elementsakling_elementsy unefrontal_image_urlyreference_image_urlsen un único arrayelement_input_urls, con la vista frontal primero y 2–4 URLs en total. Un elemento de O3 con una sola vista necesita al menos una vista más. - Elimina
output_format. El esquema rechaza los campos desconocidos. - Cambia
1Kpor2K; definesizeexplícitamente si dependías del valor por defecto16:9de O3, ya que el nuevo valor por defecto esauto. - Añade el recargo por referencia a tus estimaciones de coste.
- Aumenta los timeouts del cliente o pasa a webhooks para 8K y series.
El sondeo de estado, la lectura de files[].file_url y la verificación de webhooks no cambian. La referencia completa de la petición está en la guía de la Kling Image 4.0 API.
¿Y Kling O1 Image?
Kling O1 Image es solo de edición (kling-o1-image-edit) en 1K o 2K por 3.5 créditos por imagen. Trátalo como kling-o3-image-edit en la tabla de arriba: una edición con referencia barata, sin 4K ni 8K, sin series.
Preguntas frecuentes
¿La Kling Image 4.0 API sustituye directamente a la Kling O3 Image API?
Casi. El endpoint, la autenticación, el sondeo y los webhooks son los mismos. Cambias el ID de modelo, renombras elements a kling_elements, eliminas output_format y pasas las peticiones de 1K a 2K.
¿Qué es más barato, la Kling Image 4.0 API o Kling O3 Image? Kling O3 Image: 3.5 créditos por imagen en 1K o 2K y 7 en 4K, frente a 13, 19 y 32 créditos en 2K, 4K y 8K para Kling Image 4.0, que además añade 1 crédito por referencia.
¿Kling O3 Image admite 8K o series de imágenes?
No. Kling O3 Image en PoYo llega como máximo a 4K y devuelve 1–9 imágenes independientes. El 8K y las series con enable_sequential son funciones de la Kling Image 4.0 API.
¿Puedo seguir obteniendo JPEG de la Kling Image 4.0 API? No desde la API: la salida es PNG. Convierte tras la descarga, o mantén los trabajos en JPEG y WebP en Kling O3 Image.
¿Necesito una nueva clave de API para la Kling Image 4.0 API?
No. La misma clave de PoYo funciona para kling-4.0-image, kling-4.0-long-image, kling-o3-image y cualquier otro modelo.