Claude Opus 5.5 ya está disponible en SeedRouter

Image

Kling Image 4.0 Long Image

View Markdown

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

CampoTipoValores y valores predeterminados
modelstring, obligatoriokling-image-4-0-long-image
contentsarray, obligatorioUn elemento prompt más los elementos de imagen de referencia correspondientes al modo.
contents[].typestring, obligatorioprompt, 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[].textstringObligatorio 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[].urlstringObligatorio 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[].idstringID de referencia opcional y único entre todos los elementos de imagen de la solicitud. Menciónalo como @id en el prompt.
settings.skillstring, obligatorioecommerce para páginas de detalle de producto o webpage para diseños de páginas web.
settings.lengthstringshort (~2–5 secciones), medium (predeterminado, ~6–10 secciones) o long (~11–18 secciones). Solo se aplica a ecommerce; se ignora en webpage.
settings.resolutionstring1k (predeterminado, 1024 px de ancho) o 2k (2048 px de ancho). La altura se adapta al contenido. 4k no es compatible.
options.watermark_info.enabledbooleanOpcional. 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.