Bria

FIBO 1.5

fibo-edit-1.5/image-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-edit-1.5/image-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

fibo-edit-1.5/image-to-image per image

Precio unitario	$0.0575

Descripción general

fibo-edit-1.5/image-to-image es un modelo de edición de imágenes orientado a desarrolladores que modifica imágenes existentes mediante instrucciones. Admitir pasar de 1 a 4 imágenes de referencia a la vez, a las que se hace referencia en orden mediante las instrucciones; opcionalmente se puede usar una máscara para delimitar con precisión la zona de edición y fijar una semilla aleatoria para reproducir los resultados. Con entradas de varias imágenes se puede especificar la proporción de salida; con una sola imagen se mantiene la proporción original. Es adecuado para equipos de producto que necesitan integrar la modificación de imágenes en flujos automatizados, el procesamiento por lotes o herramientas creativas.

Puntos clave

Comprensión ordenada de varias imágenes de referencia: se pueden pasar hasta 4 imágenes y las instrucciones las referencian en el orden de subida, lo que facilita combinar varios materiales para completar la edición.
Edición local con máscara: cuando se proporciona una URL de máscara, solo se edita la zona marcada en blanco y se conserva la negra, ideal para modificar únicamente una parte de la imagen.
Semilla reproducible: con la misma semilla y las mismas entradas se obtiene la misma salida, lo que facilita la depuración, la comparación y la repetición por lotes.

Descripción de capacidades

Edición de imágenes guiada por instrucciones: describe con lenguaje natural qué quieres cambiar y el modelo devuelve directamente la imagen modificada, sin pasos manuales de retoque.

Entrada de varias imágenes y referencia ordenada: se pueden pasar de 1 a 4 imágenes a la vez y las instrucciones las referencian según su orden, lo que permite composiciones o ediciones de referencia basadas en varios materiales.

Control de la zona mediante máscara: al pasar una máscara del mismo tamaño que la imagen se delimita el alcance de la edición; la zona blanca se modifica y la negra se conserva.

Proporción de salida controlable: con varias imágenes de entrada se puede especificar una de nueve proporciones de salida; con una sola imagen se mantiene automáticamente la proporción original, lo que reduce el coste de recorte y adaptación.

Casos de uso

Equipos de comercio electrónico que modifican por lotes el fondo o los detalles locales de imágenes de producto: sube la imagen del producto y la instrucción de edición para obtener una imagen modificada lista para usarse en páginas de detalle o materiales publicitarios.
Integración en herramientas de diseño para retocar imágenes bajo demanda: el usuario delimita una máscara e introduce la modificación deseada, y el producto devuelve al instante el resultado de la edición local.
Composición con varias referencias: pasa varias imágenes de referencia y describe en orden la intención de la combinación para generar un resultado compuesto destinado a bocetos conceptuales o imágenes de marketing.

Limitaciones y recomendaciones de selección

Solo admite edición por instrucciones sobre imágenes existentes; no ofrece generación de imágenes a partir de texto. Con una sola imagen de entrada no se puede personalizar la proporción de salida, y la edición con máscara solo permite una única imagen de entrada. Para controlar con precisión el alcance de los cambios hay que preparar una máscara del mismo tamaño que la imagen; las instrucciones con varias imágenes dependen del orden de subida, por lo que quien llama debe garantizar que el orden coincida con la descripción. Es adecuado para desarrolladores que integran la modificación de imágenes en flujos automatizados, pero no para escenarios de una sola imagen que requieran generar la escena desde cero o impongan una proporción de salida concreta.

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-edit-1.5/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcionalPredeterminado: 5555

Semilla aleatoria, por defecto 5555. Una misma semilla con la misma entrada permite reproducir el mismo resultado.

mask_urlstringOpcionalminLength 1pattern ^https?://

URL opcional de una imagen de máscara, solo para edición de una única imagen: al configurarse, image_urls debe contener exactamente 1 imagen; en la máscara, las marcas blancas indican las zonas a editar y las negras se mantienen intactas, y sus dimensiones deben coincidir con las de la imagen original.

image_urlsarrayObligatoriominItems 1maxItems 4

Array de 1 a 4 URL de imágenes públicas; cada elemento es una cadena con la dirección de una imagen. El orden es significativo: instruction hace referencia a las imágenes en ese orden.

Array [ string ]

instructionstringObligatoriominLength 1

Instrucción de texto que describe qué modificación debe aplicarse a la imagen.

aspect_ratiostringOpcional

Relación de aspecto de salida, solo aplicable cuando se proporcionan 2 o más imágenes; con una sola imagen, la salida conserva la proporción de esa imagen. Si se omite, se sigue la proporción de la primera imagen.

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-edit-1.5/image-to-image",
  "input": {
    "seed": 5555,
    "image_urls": "…",
    "instruction": "…"
  }
}'

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-edit-1.5/image-to-image",
    input: {
      "seed": 5555,
      "image_urls": "…",
      "instruction": "…"
    }
  }),
});
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-edit-1.5/image-to-image",
        "input": {
          "seed": 5555,
          "image_urls": "…",
          "instruction": "…"
        }
    },
)
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"
    }
  }
}