guides

Kling Image 4.0 API: qué es Kling Image 4.0, IDs de modelo y precios

Poyo.ai Team
9 min read
Share:

Kling Image 4.0 API en PoYo: imágenes nativas en 8K, series de imágenes y diseños de página largos

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 paraSalida
kling-4.0-imageTexto a imagen (sin image_urls), imagen a imagen con 1–10 referencias, elementos, series de imágenes1–9 imágenes independientes, o una serie de 2–10, en 2K / 4K / 8K
kling-4.0-long-imageDiseños de página con skill: "webpage", páginas de detalle de producto con skill: "ecommerce" a partir de 1–3 fotos de productoUna 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:

  1. POST https://api.poyo.ai/api/generate/submit con Authorization: Bearer $POYO_API_KEY y un cuerpo JSON con model más input.
  2. Lee data.task_id de la respuesta.
  3. Consulta GET https://api.poyo.ai/api/generate/status/{task_id} hasta que status sea finished o failed, o pasa callback_url en 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

CampoValoresNotas
prompt1–50,000 caracteresObligatorio. Refiérete a las entradas como @Image1, @Element1
image_urls1–10 URLsActiva imagen a imagen. Cada imagen hasta 30 MB, al menos 300 px por lado, relación de aspecto 0.4–2.5
kling_elementshasta 7 elementosCada uno {"element_input_urls": [...]} con 2–4 vistas, la frontal primero. Requiere image_urls. Imágenes más elementos ≤ 10
sizeauto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9Por defecto auto
resolution2K, 4K, 8KPor defecto 2K. 8K es 8192×8192 en 1:1
enable_sequentialtrue / falsetrue devuelve una serie de imágenes coherente
n1–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

CampoValoresNotas
skillwebpage (por defecto), ecommerceElige el tipo de página
image_urls1–3 fotos de productoObligatorio para ecommerce
style_image_url / subject_image_urluna URL cada unoSolo webpage; @StyleImage, @SubjectImage
lengthshort, medium (por defecto), longSolo ecommerce: unas 2–5, 6–10 u 11–18 secciones
resolution1K (por defecto), 2KAncho 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ónCréditosUSD
kling-4.0-image, 2K, por imagen13$0.065
kling-4.0-image, 4K, por imagen19$0.095
kling-4.0-image, 8K, por imagen32$0.16
Cada elemento de image_urls y cada elemento de kling_elements, una vez por petición1$0.005
Imagen larga, webpage, 1K / 2K110 / 120$0.55 / $0.60
Imagen larga, ecommerce short, 1K / 2K47 / 57$0.235 / $0.285
Imagen larga, ecommerce medium, 1K / 2K94 / 110$0.47 / $0.55
Imagen larga, ecommerce long, 1K / 2K157 / 173$0.785 / $0.865
Imagen larga, cada imagen en image_urls, style_image_url o subject_image_url1$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ónSalidaCosteTiempo
kling-4.0-image, texto a imagen, 16:9, 8K, n: 1PNG de 10880×6144, unos 128 MB32 créditosunos 3.8 min
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4cuatro imágenes de 2720×1536, mismo piloto, moto y atuendo del amanecer a la noche52 créditosunos 4.9 min
kling-4.0-long-image, skill: "webpage", 1Kuna página de 1024×4257110 créditosunos 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_urls y 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.

Share: