Saltar al contenido principal
POST
Envía una solicitud asíncrona a POST /v1/images/generations con model: "kling-v4-image". Obtén data[0].task_id y consulta el resultado con GET /v1/tasks/{task_id}.

Autenticación

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

Parámetros de la solicitud

string
requerido
Debe ser kling-v4-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 para generar desde texto, desde imágenes y en serie. Describe tanto el contenido deseado como el que quieres evitar. El límite es de 50.000 caracteres para texto solo en inglés y 21.000 para texto solo en chino o idiomas similares; en textos mixtos se calcula proporcionalmente.
string[]
Hasta 10 imágenes de referencia mediante URL directas accesibles públicamente. Para archivos locales, usa la API de carga de imágenes y pasa la url devuelta.Admite JPG / JPEG / PNG / GIF. Cada imagen debe ocupar como máximo 30 MB, medir al menos 300 px tanto de ancho como de alto y tener una relación de aspecto entre 2:5 y 5:2.Las referencias se comprueban al enviar la solicitud. Una URL que devuelve HTTP 403 / 404 / 410, un lado inferior a 300 px, una proporción fuera de 2:5–5:2 o una imagen mayor de 30 MB devuelve HTTP 400 inmediatamente, sin crear una tarea ni cobrar la generación. Otros fallos de descarga, como un tiempo de espera del servidor de origen, se aceptan inicialmente; la tarea falla después y se reembolsan por completo los cargos de generación descontados por adelantado.Usa @Image1, @Image2, etc. en el prompt para referirte al orden de las imágenes en el array. También se usan como referencia sin estos marcadores.
integer
predeterminado:"1"
Cantidad de salidas en modo estándar: entero de 1 a 9, por defecto 1. En modo serie, puedes omitir n o establecerlo en 1; sequential_image_generation_options.max_images determina la cantidad de salidas. Enviar n > 1 en una serie devuelve HTTP 400.
string
predeterminado:"2K"
Admite 2K (por defecto), 4K y 8K, sin distinguir mayúsculas de minúsculas. La salida es PNG. Con 1:1, 2K equivale a 2048×2048, 4K a 4096×4096 y 8K a 8192×8192. Para otras proporciones, consulta las dimensiones reales de las imágenes devueltas.8K también admite generación desde texto, desde imágenes y en serie: 1–9 resultados en modo estándar, 2–4 en serie y hasta 10 imágenes de referencia. Los formatos, dimensiones y el límite de 30 MB por imagen de referencia no cambian.
string
predeterminado:"auto"
Relación de aspecto de salida. Admite auto (por defecto) y estas 8 proporciones:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.auto elige la proporción según el prompt o las referencias. No se admiten dimensiones en píxeles como 2048x2048.
string
Alias de size con los mismos valores. Si se proporcionan ambos, aspect_ratio tiene prioridad.
string
predeterminado:"disabled"
disabled o la omisión del campo activa la generación estándar. auto genera una serie de imágenes relacionadas y exige sequential_image_generation_options.max_images. Aquí, auto no elige automáticamente la cantidad de imágenes.
object
Define la cantidad de imágenes en modo serie.
No se admiten width, height, mask_url, size en píxeles ni watermark: true; enviarlos devuelve HTTP 400.

Ejemplos de solicitud

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

Generación desde una imagen

Generar tres imágenes 4K

Generar una imagen 8K

Generar una serie de cuatro imágenes 8K relacionadas

Establece max_images entre 2 y 4. En serie, n se puede omitir o establecer en 1, pero no puede superar 1. Una serie puede tardar varios minutos; guarda el task_id y consulta su estado para evitar envíos duplicados.

Ejemplos de resultados 8K y tiempos

Las siguientes mediciones son muestras del entorno de pruebas. Las dimensiones, los tamaños de archivo y los tiempos son orientativos; los resultados reales pueden variar. Consulta cada 5–10 segundos hasta completed o failed. estimated_time es fijo en 60 segundos y no debe usarse como estimación real ni como cuenta regresiva. Conserva el task_id y evita reenviar la solicitud mientras esperas. Los resultados 8K son PNG originales, y un archivo puede superar los 100 MB. Para listas y vistas previas, usa miniaturas que generes o carga las imágenes bajo demanda. Ofrece la descarga del original e indica que el archivo es grande.

Consultar la tarea

Consulta data.status mediante la API de consulta de tareas: pending / processing indica que está en curso, completed que terminó correctamente y failed que falló, con detalles en data.error.message.
Este ejemplo muestra la estructura de un resultado correcto. Las URL están en data.result.images[].url[]; url es un array. Recorre todas las salidas y descárgalas cuanto antes.

Facturación

Se factura según la cantidad real de imágenes generadas y la resolución elegida. Las referencias se cobran por imagen por separado. Consulta la página de precios.
  • En modo estándar, n=3 se factura como 3 salidas; en serie, se usa la cantidad realmente devuelta.
  • Cada referencia se cuenta una vez por solicitud, sin multiplicarla por la cantidad de salidas. Generar 3 imágenes con 2 referencias supone 2 entradas y 3 salidas.
  • Las tareas de generación fallidas no se cobran; los cargos de generación descontados por adelantado se reembolsan por completo.

Errores comunes de parámetros

Estos errores devuelven HTTP 400 de forma síncrona al enviar la solicitud, sin crear una tarea ni cobrar la generación. Consulta error.message para errores de envío y data.error.message para fallos después de crear la tarea.