Saltar al contenido principal
POST
Envía una solicitud asíncrona a POST /v1/images/generations con model: "kling-v4-long-image". Obtén data[0].task_id y consulta GET /v1/tasks/{task_id}. Cada solicitud devuelve un PNG vertical; el modo web genera una imagen del diseño de la página.

Elegir modo

Autenticación

string
requerido
Usa Authorization: Bearer <token>, donde <token> es tu clave API de APIMart.

Parámetros de solicitud

string
requerido
Debe ser kling-v4-long-image.
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de imagen.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Obligatorio y no puede contener solo espacios. Hasta 166.000 caracteres en inglés y 71.000 en chino o idiomas similares; el texto mixto se calcula proporcionalmente. Describe distribución, secciones, textos, estilo y sujeto.
string
requerido
Obligatorio: ecommerce para fichas de producto o webpage para diseños web, sin distinguir mayúsculas. Cada modo usa campos de referencia distintos.
string
predeterminado:"medium"
Solo para skill: "ecommerce": short, medium (por defecto) o long, aproximadamente 2–5, 6–10 o 11–18 secciones. El contenido y la altura reales dependen del resultado. Omite este campo en modo web; enviarlo devuelve HTTP 400.
string
predeterminado:"1K"
Admite 1K (por defecto) y 2K, sin distinguir mayúsculas, para todas las longitudes de comercio, incluido long + 2K. El ancho de salida es de 1024 o 2048 px respectivamente; la altura depende del contenido. No admite 4K.
string[]
Solo para comercio: 1–3 imágenes de producto obligatorias. En modo web, omite este campo y usa image_with_roles. Usa URL directas públicas. Para archivos locales, usa la API de carga de imágenes y pasa la url devuelta.
object[]
Opcional, solo para web. Como máximo una imagen style y una subject; puedes omitir una o ambas. Omite este campo en modo comercio.
integer
Cada solicitud genera una imagen larga. Omite el campo o usa el entero 1; otros valores devuelven HTTP 400.
boolean
Omite el campo o usa false; true devuelve HTTP 400.
No envíes size, aspect_ratio, width, height, mask_url, sequential_image_generation ni sequential_image_generation_options. Incluso null o una cadena vacía en estos campos devuelve HTTP 400.

Requisitos y referencias en el prompt

Admite JPG / JPEG / PNG. Máximo 30 MB por imagen, al menos 300 px por lado y proporción entre 2:5 y 5:2. Una URL con HTTP 403 / 404 / 410, dimensiones o proporciones inválidas o un archivo demasiado grande devuelve HTTP 400 síncrono, sin tarea ni cargo de generación. Otros fallos de descarga, como un tiempo de espera del servidor de origen, se aceptan inicialmente; después la tarea falla y se reembolsa el importe anticipado. Usa @Image1, @Image2, etc. En comercio se sigue el orden de image_urls; en web, primero estilo y después sujeto. Si solo se proporciona una imagen, es @Image1.

Ejemplos de solicitud

Envía las solicitudes a POST /v1/images/generations. Sustituye las URL de ejemplo por enlaces directos accesibles.

Ficha de producto larga en 2K

Web con referencias de estilo y sujeto

Web solo a partir del prompt

Consultar la tarea

Consulta la API de tareas aproximadamente cada 10 segundos. Conserva el task_id y evita duplicar la solicitud de generación durante esperas largas.
Este ejemplo muestra la estructura de un resultado correcto. images y url son arrays; este modelo devuelve una imagen larga por solicitud.
Descarga la imagen antes de la marca de tiempo Unix en segundos de data.result.images[0].expires_at. El enlace caduca después.
La generación suele tardar varios minutos; una muestra long + 2K tardó 432 segundos. estimated_time devuelve actualmente 60 segundos fijos: no lo uses como cuenta atrás ni umbral de espera. La duración varía con el contenido y la carga; la muestra no es un límite.La altura y el tamaño del archivo varían según el contenido. Una muestra long + 2K tenía 2048×46615 y 63,9 MB; no son límites de salida. Los resultados pueden superar 50 MB, por lo que conviene considerar el coste de descarga y visualización de imágenes grandes.

Facturación

Cada solicitud cobra una imagen larga al nivel de salida elegido, más las referencias: precio del nivel de salida + cantidad de referencias × precio por referencia. Producto, estilo y sujeto cuentan; la primera referencia también se cobra. Hay 8 niveles de salida, indicados a continuación. Claves: kling-v4-long-image@<nivel> y kling-v4-long-image@input para referencias. En la solicitud de generación, resolution sigue aceptando solo 1K o 2K. El importe se descuenta al enviar, se liquida al completar y se devuelve íntegramente si falla. Consulta la página de precios para tarifas y descuentos de la cuenta.

Errores comunes

Estos errores devuelven HTTP 400 síncrono, sin tarea ni cargo de generación. Lee error.message para errores de envío y data.error.message para fallos después de crear la tarea.