
La Kling Image 4.0 API da a los desarrolladores acceso al modelo de imagen más reciente de Kling AI a través de un único endpoint de PoYo: llama a kling-4.0-image para texto a imagen, edición y series de imágenes en 2K, 4K u 8K, y a kling-4.0-long-image para diseños completos de páginas web o de ecommerce. Esta página explica qué es Kling Image 4.0, qué hace cada campo de la petición, los límites y cuánto cuesta una llamada en PoYo.
¿Qué es Kling Image 4.0?
Kling Image 4.0 es el modelo de imagen de la familia Kling 4.0 de Kling AI, la plataforma creativa de IA de Kuaishou. Se lanzó el 17 de noviembre de 2026. En su publicación de lanzamiento, Kling afirma que el modelo:
- genera imágenes en 8K nativo, que Kling introduce por primera vez con este modelo;
- crea hasta 10 imágenes a partir de un prompt con estilo y contenido coherentes;
- renderiza hasta 2,000 caracteres de texto en una imagen, en inglés, chino simplificado, chino tradicional, japonés, coreano, español y portugués;
- produce imágenes de formato largo para páginas de detalle de producto de ecommerce y diseño web.
Kling también indica que el modelo está disponible en Kling Creative Studio y por API para empresas y desarrolladores. PoYo añadió la Kling Image 4.0 API en noviembre de 2026, sin lista de espera y con la misma clave de API que usas para cualquier otro modelo de PoYo.
IDs de modelo de la Kling Image 4.0 API en PoYo
| ID de modelo | Úsalo para | Salida |
|---|---|---|
kling-4.0-image | Texto a imagen (sin image_urls), imagen a imagen con 1–10 referencias, elementos, series de imágenes | 1–9 imágenes independientes, o una serie de 2–10, en 2K / 4K / 8K |
kling-4.0-long-image | Diseños de página con skill: "webpage", páginas de detalle de producto con skill: "ecommerce" a partir de 1–3 fotos de producto | Una imagen alta, de 1024 px (1K) o 2048 px (2K) de ancho |
Ambos IDs usan el mismo endpoint de envío, el mismo sondeo de tareas y el mismo webhook callback_url. El slug de la landing page es kling-4-0-image; los IDs de modelo de la petición usan puntos (kling-4.0-image).
Endpoint y estructura de la petición
Cada petición a la Kling Image 4.0 API es una tarea asíncrona:
POST https://api.poyo.ai/api/generate/submitconAuthorization: Bearer $POYO_API_KEYy un cuerpo JSON conmodelmásinput.- Lee
data.task_idde la respuesta. - Consulta
GET https://api.poyo.ai/api/generate/status/{task_id}hasta questatusseafinishedofailed, o pasacallback_urlen el nivel superior y recibe un POST cuando termine la tarea.
Una petición mínima en 4K, copiada de la estructura de la documentación:
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
Una tarea terminada devuelve las imágenes en data.files, cada una con file_url y file_type: "image". Las series de imágenes se devuelven en orden. Comprueba el campo code del cuerpo además del estado HTTP: PoYo puede devolver HTTP 200 con code: 400 ante un error de validación. La versión paso a paso con cURL y Python está en la guía de la Kling Image 4.0 API.
Campos de entrada y límites
kling-4.0-image
| Campo | Valores | Notas |
|---|---|---|
prompt | 1–50,000 caracteres | Obligatorio. Refiérete a las entradas como @Image1, @Element1 |
image_urls | 1–10 URLs | Activa imagen a imagen. Cada imagen hasta 30 MB, al menos 300 px por lado, relación de aspecto 0.4–2.5 |
kling_elements | hasta 7 elementos | Cada uno {"element_input_urls": [...]} con 2–4 vistas, la frontal primero. Requiere image_urls. Imágenes más elementos ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Por defecto auto |
resolution | 2K, 4K, 8K | Por defecto 2K. 8K es 8192×8192 en 1:1 |
enable_sequential | true / false | true devuelve una serie de imágenes coherente |
n | 1–9 (independientes) o 2–10 (serie) | Valores por defecto 1 y 4 |
El esquema rechaza los campos desconocidos, así que no envíes output_format, seed ni negative_prompt. La salida es PNG.
kling-4.0-long-image
| Campo | Valores | Notas |
|---|---|---|
skill | webpage (por defecto), ecommerce | Elige el tipo de página |
image_urls | 1–3 fotos de producto | Obligatorio para ecommerce |
style_image_url / subject_image_url | una URL cada uno | Solo webpage; @StyleImage, @SubjectImage |
length | short, medium (por defecto), long | Solo ecommerce: unas 2–5, 6–10 u 11–18 secciones |
resolution | 1K (por defecto), 2K | Ancho de 1024 o 2048 px; la altura depende del contenido |
Cada petición de imagen larga devuelve una imagen.
Precios de la Kling Image 4.0 API en PoYo
PoYo cobra por imagen generada (1 crédito = $0.005). Los créditos solo se cobran cuando la tarea tiene éxito.
| Petición | Créditos | USD |
|---|---|---|
kling-4.0-image, 2K, por imagen | 13 | $0.065 |
kling-4.0-image, 4K, por imagen | 19 | $0.095 |
kling-4.0-image, 8K, por imagen | 32 | $0.16 |
Cada elemento de image_urls y cada elemento de kling_elements, una vez por petición | 1 | $0.005 |
| Imagen larga, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Imagen larga, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Imagen larga, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Imagen larga, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Imagen larga, cada imagen en image_urls, style_image_url o subject_image_url | 1 | $0.005 |
El desglose de precios incluye las tablas de imágenes largas y ejemplos calculados.
Lo que medimos el día del lanzamiento
El equipo de PoYo ejecutó estas peticiones en la API de producción el 19 de noviembre de 2026. Los tiempos van del envío al resultado tal como los ve un cliente que hace sondeo, así que tómalos como aproximados.
| Petición | Salida | Coste | Tiempo |
|---|---|---|---|
kling-4.0-image, texto a imagen, 16:9, 8K, n: 1 | PNG de 10880×6144, unos 128 MB | 32 créditos | unos 3.8 min |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | cuatro imágenes de 2720×1536, mismo piloto, moto y atuendo del amanecer a la noche | 52 créditos | unos 4.9 min |
kling-4.0-long-image, skill: "webpage", 1K | una página de 1024×4257 | 110 créditos | unos 1.7–2.2 min |
Dos notas de integración de esa misma prueba. Las descargas fueron archivos PNG con canal alfa (RGBA) incluso para imágenes opacas, así que convierte explícitamente si tu pipeline espera RGB o JPEG. Y un prompt largo de página web en inglés que no indicaba el idioma del texto de la página devolvió texto en chino; añadir "All text on the page is in English." lo solucionó. Más sobre ambos puntos en 8K e imágenes largas.
¿Qué peticiones deberían ir a la Kling Image 4.0 API?
- Impresión, vallas publicitarias y trabajos con muchos recortes que necesitan más de 4K: es el único modelo de imagen en PoYo con un nivel
8K. - Storyboards, ángulos de producto y presentaciones en los que un personaje o producto debe mantenerse igual en todos los fotogramas: usa
enable_sequential. - Colocar un producto o personaje conocido en una escena nueva: pasa la escena en
image_urlsy el sujeto como elemento con varios ángulos. - Maquetas de landing pages y páginas de detalle de ecommerce como una sola imagen:
kling-4.0-long-image.
Para borradores rápidos en 1K–2K al precio más bajo, Kling O3 Image es más barato por imagen; consulta Kling Image 4.0 API vs Kling O3 Image. Para compararlo con otros proveedores, lee Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Preguntas frecuentes
¿Qué es la Kling Image 4.0 API?
Es el acceso REST de PoYo al modelo Kling Image 4.0 de Kling AI, con los IDs de modelo kling-4.0-image (imágenes estándar, ediciones y series de imágenes) y kling-4.0-long-image (páginas web largas y páginas de ecommerce). Ambos usan POST /api/generate/submit y la misma clave de API.
¿Cuánto cuesta la Kling Image 4.0 API? 13 créditos ($0.065) por imagen en 2K, 19 créditos ($0.095) en 4K y 32 créditos ($0.16) en 8K, más 1 crédito ($0.005) por imagen de referencia o elemento, una vez por petición. Las imágenes largas cuestan de 47 a 173 créditos por página. Las tareas fallidas no se cobran.
¿La Kling Image 4.0 API admite imagen a imagen?
Sí. Pasa de 1 a 10 URLs en image_urls con kling-4.0-image y refiérete a ellas en el prompt como @Image1, @Image2. Añade hasta 7 kling_elements para personajes u objetos coherentes; imágenes más elementos tienen un máximo de 10.
¿Cuánto tarda una petición a la Kling Image 4.0 API?
En nuestra prueba del día del lanzamiento, una imagen 16:9 en 8K tardó unos 3.8 minutos, una serie de cuatro imágenes en 2K unos 4.9 minutos y una página web en 1K unos 2 minutos. Para trabajos grandes, usa callback_url en lugar de mantener una petición abierta.
¿Dónde está la documentación de la Kling Image 4.0 API? La referencia de campos está en la documentación de Kling Image 4.0 y en la documentación de imágenes largas. La página del modelo tiene un playground que muestra el JSON de tu configuración.