Bria

FIBO 1.5

fibo-gen-1.5/text-to-image

Modelo de imagen destilado de DiT de flujo continuo de 8B de BRIA, capaz de generar imágenes con muestreo de pocos pasos de 4 a 6 pasos, compatible con indicaciones estructuradas en JSON y permite edición desacoplada por atributos

fibo-edit-1.5/image-to-image fibo-gen-1.5/text-to-image

Probar fibo-gen-1.5/text-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

fibo-gen-1.5/text-to-image per image

Precio unitario	$0.0575

Descripción general

fibo-gen-1.5 es la línea de texto a imagen de la familia fibo-1.5, dirigida a desarrolladores que necesitan control de nivel profesional y reproducibilidad. Se basa en una arquitectura DiT de 8B parámetros con flow matching, emplea muestreo destilado de pocos pasos, requiere solo 4–6 pasos y CFG=1.0 para completar la inferencia, y continúa el paradigma de prompts largos estructurados, con una sólida capacidad de adherencia a atributos como iluminación, composición, color y encuadre. Es adecuada para escenarios de producción de imágenes que integran la generación por lotes, la iteración a nivel de atributos y la reproducibilidad de resultados en flujos de trabajo de ingeniería.

Aspectos clave

Muestreo de pocos pasos que reduce notablemente el coste de inferencia por imagen: tras la destilación solo requiere 4–6 pasos y no necesita classifier-free guidance, con un coste de llamada menor que los flujos multipaso tradicionales con CFG alto.
Los prompts largos estructurados aportan una fuerte adherencia al prompt: la generación se guía mediante descripciones largas que detallan atributos como sujeto, iluminación, composición, color y encuadre, lo que hace más explícito el control en escenarios profesionales.
Resultados de generación reproducibles: el seed se fija por defecto en 5555; con el mismo seed y prompt se puede reproducir la misma imagen, lo que facilita las canalizaciones por lotes y la validación de regresiones.
Reparto de funciones en la familia entre texto a imagen y edición de imagen: la misma familia cuenta además con la línea de edición de imagen fibo-edit-1.5, a la que se puede cambiar cuando se necesita modificar una imagen a partir de una referencia.

Descripción de capacidades

Muestreo destilado de pocos pasos: con la configuración recomendada de 4–6 pasos y CFG=1.0 ya se generan imágenes, lo que evita el ajuste de parámetros y el consumo de cómputo de los flujos tradicionales con CFG alto y permite devolver resultados utilizables más rápido en cada solicitud.

Adherencia a prompts estructurados: el entrenamiento y la inferencia se basan en descripciones largas estructuradas de alrededor de mil palabras; si el desarrollador detalla uno a uno atributos como sujeto, iluminación, composición y encuadre, puede obtener imágenes más cercanas a lo esperado.

Generación reproducible: el parámetro seed y el prompt determinan conjuntamente la salida; fijando ambos se reproduce la misma imagen, lo que resulta adecuado para comparar versiones y rastrear resultados en la producción por lotes.

Múltiples relaciones de aspecto: incluye nueve relaciones integradas: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16 y 16:9, que pueden elegirse directamente según la ubicación de publicación o el formato, reduciendo el recorte posterior.

Entrada de prompts largos: el prompt admite hasta 10000 caracteres, de modo que las descripciones largas estructuradas pueden escribirse completas sin necesidad de comprimirlas en frases cortas, lo que permite expresar los atributos con mayor detalle.

Escenarios de aplicación

Diseñadores de imagen comercial: generación con prompts largos estructurados: escribir en el prompt la iluminación, la composición, el color y el encuadre punto por punto para producir imágenes de nivel comercial utilizables directamente en materiales publicitarios y de comercio electrónico.
Equipos creativos: refinamiento iterativo a nivel de atributos: fijar el seed y cambiar solo un atributo para generar repetidamente y obtener variantes de una serie con las que comparar propuestas, reduciendo el retrabajo de reescribir todo el prompt.
Equipos de ingeniería: generación por lotes reproducible: llamar por lotes con un seed fijo y prompts largos plantilla para producir recursos de imagen coherentes en estilo y rastreables, destinados a la canalización de producción de contenido.
Desarrolladores de aplicaciones: generación adaptada a múltiples proporciones: elegir la relación de aspecto según el formato de destino y generar recursos de imagen que se integran directamente en apps, web y portadas de vídeo.

Limitaciones y recomendaciones de selección

El prompt negativo no tiene efecto en esta versión, por lo que la imagen debe restringirse por completo mediante descripciones positivas; la ponderación indicada por la documentación oficial no se aplica al ajuste fino. Reutilizar flujos de trabajo multipaso antiguos con CFG alto se aleja del efecto esperado; debe usarse con CFG=1.0 y 4–6 pasos. La ventaja de control depende de prompts largos estructurados; los prompts cortos habituales aportan beneficios limitados. La escala de 8B supone una carga considerable para el hardware de consumo local, y el despliegue solo local requiere versiones cuantizadas; llamar a través de HiAPI.ai no implica este problema.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: fibo-gen-1.5/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para fibo-gen-1.5/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcionalPredeterminado: 5555

Semilla aleatoria, por defecto 5555; con la misma semilla y el mismo prompt se puede reproducir la misma imagen.

promptstringObligatoriominLength 1maxLength 10000

Descripción textual de la imagen a generar, es decir, el prompt de texto a imagen.

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de la imagen de salida, por defecto 1:1.

Opciones:1:12:33:23:44:34:55:49:16

Mostrar todo (1)

16:9

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "fibo-gen-1.5/text-to-image",
  "input": {
    "seed": 5555,
    "prompt": "…",
    "aspect_ratio": "1:1"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "fibo-gen-1.5/text-to-image",
    input: {
      "seed": 5555,
      "prompt": "…",
      "aspect_ratio": "1:1"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "fibo-gen-1.5/text-to-image",
        "input": {
          "seed": 5555,
          "prompt": "…",
          "aspect_ratio": "1:1"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}