Image
Kling Image 4.0 Long Image
Genera páginas de detalle ecommerce y diseños visuales de páginas web verticales en 1K o 2K con Kling Image 4.0 Long Image; después, consulta el estado hasta obtener la URL del PNG terminado.
Envía una solicitud JSON a POST /v1/images/generations con el ID de modelo kling-image-4-0-long-image. Guarda el ID de tarea devuelto y consulta GET /v1/tasks/{id} hasta que se complete el PNG vertical.
Ejemplo rápido
Esta solicitud crea un diseño de página web en 1K a partir de un brief de texto. Guarda tu clave de API en SEEDROUTER_API_KEY.
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'Endpoint y encabezados
Envía JSON a POST https://api.seedrouter.ai/v1/images/generations con Content-Type: application/json y Authorization: Bearer YOUR_API_KEY. Mantén la clave únicamente en tu servidor.
Parámetros
| Campo | Tipo | Valores y valores predeterminados |
|---|---|---|
model | string, obligatorio | kling-image-4-0-long-image |
contents | array, obligatorio | Un elemento prompt más los elementos de imagen de referencia correspondientes al modo. |
contents[].type | string, obligatorio | prompt, refer_image (solo ecommerce, de 1 a 3 obligatorias), style_refer_image (solo webpage, como máximo 1) o subject_refer_image (solo webpage, como máximo 1). element no es compatible. |
contents[].text | string | Obligatorio para prompt. Límite de 166.000 caracteres solo en inglés y 71.000 en otros idiomas. El texto mixto debe cumplir english / 166000 + non_english / 71000 <= 1. |
contents[].url | string | Obligatorio para cada elemento de imagen. URL HTTP(S) pública de un archivo JPEG o PNG de hasta 30 MB, con al menos 300 px por lado y una relación de aspecto de 2:5 a 5:2. |
contents[].id | string | ID de referencia opcional y único entre todos los elementos de imagen de la solicitud. Menciónalo como @id en el prompt. |
settings.skill | string, obligatorio | ecommerce para páginas de detalle de producto o webpage para diseños de páginas web. |
settings.length | string | short (~2–5 secciones), medium (predeterminado, ~6–10 secciones) o long (~11–18 secciones). Solo se aplica a ecommerce; se ignora en webpage. |
settings.resolution | string | 1k (predeterminado, 1024 px de ancho) o 2k (2048 px de ancho). La altura se adapta al contenido. 4k no es compatible. |
options.watermark_info.enabled | boolean | Opcional. Solo se admite false. |
Página de detalle ecommerce
El modo ecommerce exige de 1 a 3 entradas refer_image. Haz referencia a cada foto por su id dentro del prompt.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}Diseño web con referencias de estilo y sujeto
El modo webpage admite entradas opcionales style_refer_image (como máximo 1) y subject_refer_image (como máximo 1). Omite settings.length en modo webpage.
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}Recuperar la imagen larga
Copia el campo id de la respuesta del POST en TASK_ID y consulta el estado hasta que sea completed o failed. Las tareas de imagen larga suelen tardar varios minutos, sobre todo en diseños long + 2k.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"Cuando termine, lee output.data[0].url. Cada solicitud genera un único PNG vertical completo. En 2k, las páginas altas pueden superar los 50 MB, así que planifica en consecuencia los tiempos de espera de descarga y el escalado en tu visor. Consulta la referencia de tareas y el directorio de errores.
Precios
Cada solicitud completada cobra la tarifa de un nivel de salida (ecommerce según resolution × length, o webpage según resolution) más un cargo por imagen de referencia por cada imagen de entrada (incluida la primera). Las solicitudes fallidas no tienen coste. Consulta las tarifas actuales.
Errores y consejos
Las solicitudes no válidas devuelven HTTP 400 antes de facturarse. Entre los errores de validación más frecuentes están omitir settings.skill, enviar ecommerce sin entre 1 y 3 URL de refer_image, mezclar refer_image con el modo webpage, solicitar 4k o duplicar IDs de referencia.
Indica el orden exacto de las secciones en tu prompt —desde el banner principal hasta las especificaciones o el pie de página— e incluye únicamente datos verificados del producto para que el diseño mantenga la precisión. Consulta el Playground de Kling Image 4.0 Long Image y el esquema OpenAPI.
