FLUX 3 Image Klein

Genera o edita una imagen con hasta diez URL de referencia, cinco niveles de resolución y resultados de tarea asíncronos.

Ejemplo rápido

Envía una solicitud de imagen, guarda el id devuelto y sondea hasta que la tarea esté completed o failed. Esta API utiliza tareas asíncronas y salidas mediante URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

Endpoint y cabeceras

POST https://api.seedrouter.ai/v1/images/generations

Cabecera	Valor
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Guarda la clave en tu servidor. Un éxito HTTP confirma una tarea; no significa que su imagen esté lista.

Parámetros

Se aceptan 11 campos. Solo model y prompt son obligatorios. Omite los opcionales para usar sus valores predeterminados; no se acepta null.

Campo	Tipo	Predeterminado	Restricción
`model`	cadena	Obligatorio	`flux-3-image-klein`
`prompt`	cadena	Obligatorio	Descripción de imagen o instrucción de edición no vacía
`image_urls`	matriz de cadenas	Ninguno	Hasta 10 URL públicas HTTP(S) de imágenes, sin credenciales; una matriz vacía significa sin referencias
`aspect_ratio`	cadena	`auto`	Una proporción listada; también acepta formas como `16x9`
`size`	cadena	Ninguno	Alias de compatibilidad de proporción; prefiere `aspect_ratio` y envía solo uno
`resolution`	cadena	`1k`	`768sq`, `1k`, `1.5k`, `2k`, `4k`; no distingue mayúsculas; `768` es alias de `768sq`
`safety_tolerance`	entero	`2`	0–4; 0 es el más estricto
`seed`	entero	Aleatorio	0–4294967295; se conserva el 0 explícito
`steps`	entero	`16`	1–16
`output_format`	cadena	`jpeg`	`jpeg`, `png`; `jpg` es alias de `jpeg`
`n`	entero	`1`	Solo 1

Proporciones: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

El Playground tiene un modelo fijo y diez controles, incluido n fijado en 1. Salvo para administradores, los valores de seguridad superiores a 2 son solo para API.

Sin referencias, se genera desde texto. Una referencia permite editar; varias permiten componer con múltiples imágenes. Con auto, la edición sigue la proporción de la primera referencia. La generación solo con texto elige un encuadre según el prompt y usa 1:1 si no lo determina. La resolución predeterminada es 1k en todos los modos.

Los niveles representan una escala aproximada: 768sq equivale a unos 768 × 768; 1K a 1 MP; 1.5K a 2 MP; 2K a 4 MP; 4K a 16 MP. Comprueba el archivo devuelto para conocer sus dimensiones reales.

Este endpoint no acepta width, height, dimensiones en píxeles en size, negative_prompt, guidance, grounding, prompt_upsampling, mask ni mask_url. Los campos desconocidos devuelven HTTP 400 antes de facturar. No se ofrecen salida WebP, entrada base64, streaming ni callbacks.

Imágenes de referencia y ediciones por zonas

Sube las referencias a una URL pública antes de enviar. El cuerpo contiene URL, nunca bytes de archivo ni data URL.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

Sustituye las URL de ejemplo por imágenes propias accesibles. Las referencias tienen orden: ref_image_0 es la primera. Las instrucciones de cajas delimitadoras forman parte de la cadena prompt, no de un campo separado. Las coordenadas usan [y1, x1, y2, x2], normalizadas a 0–1000. Un objeto de diseño puede contener id, bbox y desc; una edición puede usar id, from, src_bbox, tgt_bbox y desc. Codifica toda la solicitud en JSON para escapar las comillas del prompt correctamente.

Facturación

Una solicitud completada produce una imagen. Solo la resolución elegida determina el precio; pasos, semilla, proporción, referencias y formato no añaden cargos. Texto a imagen y edición tienen la misma tarifa. Las solicitudes fallidas no se cobran. Consulta los precios en vivo.

Respuesta y sondeo de tareas

Envío:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

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

Tarea completada (URL ilustrativa):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

Lee output.data[0].url. Permite hasta diez minutos para generar, especialmente en 4K. El sondeo es de solo lectura; un timeout del cliente no autoriza otra solicitud de pago. Las respuestas públicas no incluyen costes ni saldos de cuenta.

Errores

Los errores HTTP usan {"error": {"code": integer, "message": string}}. Consulta el directorio común de errores. Una tarea fallida expone su error junto a status: "failed". Corrige parámetros inválidos antes de reenviar y conserva el ID al consultar una solicitud ya enviada.

Consejos y guías relacionadas

Usa descripciones positivas y nombra las zonas o detalles que deben conservarse. Reducir pasos puede cambiar la calidad sin bajar el precio. Compara un solo cambio cada vez.