Claude Opus 5.5 ya está disponible en SeedRouter

Image

Kling Image 4.0

View Markdown

Crea imágenes en 2K o 4K con Kling Image 4.0. Usa fotos de referencia con nombre para generar variaciones de una sola imagen o una serie relacionada; después, consulta el estado hasta obtener las URL de las imágenes terminadas.

Envía una solicitud JSON a POST /v1/images/generations con el ID del modelo kling-image-4-0. Guarda el ID de tarea que recibas. El mismo endpoint acepta descripciones solo de texto y descripciones guiadas por referencias.

Ejemplo rápido

Esta solicitud crea una imagen fija cuadrada en 2K. Guarda tu clave de API en la variable de entorno 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",
    "contents": [
      {"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
    ],
    "settings": {"resolution": "2k", "aspect_ratio": "1:1"}
  }'

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. Guarda la clave en tu servidor.

Parámetros

CampoTipoValores y valores predeterminados
modelcadena, obligatoriokling-image-4-0
contentsmatriz, obligatorioUn prompt y de cero a diez imágenes de referencia.
contents[].typecadena, obligatorioprompt o refer_image.
contents[].textcadenaObligatorio para el prompt. Límite de 50.000 caracteres en inglés y de 21.000 en otros idiomas. En textos mixtos, la suma de las fracciones de sus respectivos límites no puede superar uno.
contents[].urlcadenaObligatorio para cada referencia. Usa una URL HTTP(S) accesible para un JPEG o PNG de hasta 30 MB. Ambos lados deben medir al menos 300 píxeles y la proporción entre el ancho y el alto debe estar entre 2:5 y 5:2.
contents[].idcadenaNombre único opcional para una referencia. Menciona el nombre como @name en el prompt.
settings.result_typecadenasingle (predeterminado) para imágenes independientes o series para imágenes relacionadas.
settings.nenteroDe 1 a 9 imágenes independientes. El valor predeterminado es 1. Solo se usa en el modo individual.
settings.series_amountentero o cadenaEn el modo serie, de 2 a 4 imágenes; el valor predeterminado es 4. En el modo individual, este campo se ignora y puede ser un entero de 2 a 10 o la cadena auto.
settings.resolutioncadena2k (predeterminado) o 4k.
settings.aspect_ratiocadenaauto (predeterminado), 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 o 21:9.
options.watermark_info.enabledbooleanoOpcional. Solo se admite false.

Una serie a partir de una foto de referencia

Sustituye la URL de ejemplo por una URL pública de la foto de tu producto. Este ejemplo solicita tres imágenes relacionadas. Incluye en el mismo prompt las instrucciones para cada fotograma.

{
  "model": "kling-image-4-0",
  "contents": [
    {"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
    {"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
  ],
  "settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}

Recupera todas las imágenes

Copia el id de la respuesta POST en TASK_ID. Consulta este endpoint con la misma clave hasta que el estado de la tarea sea completed o failed.

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Cuando la tarea termine, lee todas las URL de output.data[].url. Una tarea puede devolver varias imágenes. Si se interrumpe una consulta de estado, vuelve a buscar la tarea por su ID original. Consulta la referencia de tareas para conocer su ciclo de vida y el directorio de errores para ver los códigos de error.

Precios

El total se calcula multiplicando el número de imágenes generadas en la resolución solicitada por la tarifa vigente por imagen, y sumando un cargo por cada imagen de referencia de entrada. Cuatro imágenes en 4K con dos referencias cuestan cuatro cargos por imagen de salida en 4K y dos cargos por referencias. Las solicitudes fallidas no generan cargos. Consulta las tarifas vigentes.

Errores y consejos

Las entradas no válidas devuelven un error de solicitud. Comprueba que no falte el texto del prompt, que no haya ID de referencia duplicados y que la resolución y la configuración de la serie sean compatibles. Si la llamada inicial devolvió un ID de tarea, consulta ese ID antes de decidir si hace falta enviar otra solicitud.

Para una descripción con varias referencias, usa un nombre distinto para cada sujeto e indica al modelo qué características visuales aporta cada referencia. Incluye en el prompt las indicaciones de cámara y la secuencia de planos. Consulta el entorno de pruebas de Kling Image 4.0 y el esquema OpenAPI.