Guía de la API de FLUX 3 Image Klein: precios de cinco niveles de resolución, parámetros y ejemplos de llamada

Qué es FLUX 3 Image Klein

FLUX 3 Image Klein es el modelo de imagen ligero de la serie FLUX 3 de Black Forest Labs. En HiAPI solo hay un ID de modelo: flux-3-image-klein, y se usa tanto para generar imágenes a partir de texto como para editar con imágenes de referencia. Si solo se escribe un prompt, es generación de imágenes a partir de texto; si además se añade image_urls, se modifica la escena según las imágenes de referencia o se fusionan los estilos de varias imágenes.

Sus ventajas son que es económico y tiene muchos niveles: desde 768 hasta 4K, cinco niveles de resolución en total, ideal para generar imágenes en lote y para el flujo de probar con imágenes pequeñas y luego finalizar con imágenes grandes.

Precio: por nivel de resolución, facturado por imagen

• 768: $0.0092 / imagen
• 1K (predeterminado): $0.0103 / imagen
• 1.5K: $0.0126 / imagen
• 2K: $0.016 / imagen
• 4K: $0.0412 / imagen

Las imágenes de referencia no tienen coste adicional: el mismo precio con 1 o con 10 imágenes. Reducir steps tampoco abarata el precio; el precio solo depende de resolution. Si la tarea falla, se reembolsa el importe completo.

Por ejemplo: probar 50 imágenes de estilo en el nivel 768 cuesta $0.46, y elegir 5 para generar el resultado final en 4K cuesta $0.206.

Parámetros

Excepto model y prompt, todos son parámetros opcionales:

• prompt: obligatorio, de 1 a 5000 caracteres.
• resolution: 768, 1K, 1.5K, 2K, 4K; predeterminado 1K.
• aspect_ratio: 16 valores posibles, incluidos 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 y auto (predeterminado).
• image_urls: de 1 a 10 imágenes de referencia accesibles públicamente, si no se especifican es generación de imágenes puramente a partir de texto.
• steps: de 1 a 16, predeterminado 16. Cuantos menos pasos, más rápida es la generación, aunque puede reducirse el detalle.
• seed: de 0 a 4294967295. Con una semilla fija, los mismos parámetros reproducirán en la medida de lo posible resultados similares; si no se especifica, es aleatoria.
• safety_tolerance: de 0 a 4, predeterminado 2. Cuanto mayor sea el número, más permisiva será la moderación.
• output_format: jpeg (predeterminado) o png.

Ejemplos de solicitud

Las tareas de imagen son asíncronas: primero se crea la tarea y luego se consulta el resultado. model va en el nivel superior y el resto de parámetros dentro de input.

Generación de imagen a partir de texto, 2K, imagen vertical 4:5, semilla fija:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "Una taza de café de cerámica sobre una mesa de madera iluminada por la luz de la mañana, poca profundidad de campo, tonos cálidos, fotografía de producto",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

Esta imagen cuesta $0.016.

Edición con imágenes de referencia, fusión del estilo de dos imágenes:

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "Conserva la estructura arquitectónica de la primera imagen y vuelve a dibujarla con las pinceladas de acuarela y la paleta de colores de la segunda imagen",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

Tras crearla correctamente, consulta con el ID de tarea devuelto mediante GET https://api.hiapi.ai/v1/tasks/{taskId}; cuando termine correctamente, obtén la dirección de la imagen de la salida.

Recomendaciones de uso

• Primero pequeño, luego grande: prueba el prompt con 768 o 1K y un seed fijo; cuando estés satisfecho, cambia solo resolution a 2K o 4K y vuelve a generar.
• Variantes en lote: con el mismo prompt, cambia distintos seed para obtener un conjunto de candidatas con composiciones diferentes y estilo coherente.
• Al editar imágenes, indica claramente qué conservar: cuando uses imágenes de referencia, especifica en el prompt qué debe conservarse y qué debe modificarse; esto es más estable que describir solo la escena objetivo.

Limitaciones actuales

• Cada llamada devuelve una imagen.
• Máximo 10 imágenes de referencia, que deben ser direcciones http(s) accesibles públicamente.
• No hay opción de fondo transparente; png solo cambia a un formato sin pérdida.