Bria
FIBO 2.0
fibo-2.0/image-to-image
Modelo de imagen unificado lanzado por Bria que realiza generación de imágenes a partir de texto y edición de imágenes basada en instrucciones dentro del mismo modelo, permitiendo introducir hasta cuatro imágenes durante la edición; entrenado únicamente con datos autorizados, ideal para arte conceptual, imágenes fijas de marketing y fotografía de productos de comercio electrónico
Probar fibo-2.0/image-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
fibo-2.0/image-to-image per image
| Precio unitario | $0.0572 |
|---|
Descripción general
Este modelo de imagen a imagen permite modificar o componer una imagen tomando como base una imagen a editar y combinándola con hasta tres imágenes de referencia e instrucciones en lenguaje natural. La indicación (prompt) admite hasta 10000 caracteres y se pueden usar referencias numeradas como <image_1> para aludir a las imágenes de entrada; la salida es de aproximadamente un millón de píxeles y la relación de aspecto se puede especificar eligiendo una entre veintiún preajustes. Es adecuado para diseñadores y desarrolladores que necesitan ajustar la imagen de forma dirigida según instrucciones, fusionar varios recursos y controlar la proporción de la composición, en escenarios como iteración de conceptos y creación de materiales de marketing.
Aspectos clave
- Edición y composición de múltiples imágenes guiadas por instrucciones: se parte de una imagen a editar y se pueden añadir hasta tres imágenes de referencia, citadas mediante números en las instrucciones, para lograr modificaciones locales o la fusión de varias imágenes.
- Relación de aspecto de salida flexible y seleccionable: se ofrecen veintiún preajustes de relación de aspecto; con varias imágenes de entrada se puede especificar la proporción de salida según sea necesario, mientras que la edición de una sola imagen conserva la proporción original.
- Semilla para resultados reproducibles: al pasar una semilla aleatoria entre 0 y 2147483647, la misma semilla con las mismas entradas produce una salida idéntica, lo que facilita las comparaciones A/B.
- Máscara que delimita el área de edición local: se puede proporcionar opcionalmente una imagen de máscara para designar la zona de edición; las áreas blancas se modifican y las negras se conservan. Solo se aplica a la edición de una sola imagen y la máscara debe tener el mismo tamaño que la imagen original.
Capacidades
Edición y composición de varias imágenes mediante instrucciones: se introducen de 1 a 4 URL de imágenes públicas; la primera es la imagen a editar y las otras, hasta tres, son imágenes de referencia. En las instrucciones se pueden citar las imágenes en orden con <image_1>, <image_2>, etc., para realizar modificaciones locales o fusionar elementos entre imágenes.
Modificación local restringida por máscara: al proporcionar una imagen de máscara solo se admite la edición de una sola imagen (image_urls solo puede contener 1); las áreas blancas son las que se van a modificar y las negras se conservan. La máscara debe tener el mismo tamaño que la imagen original, lo que la hace adecuada para sustituciones locales precisas.
Relación de aspecto de salida especificable según necesidad: con varias imágenes de entrada se puede elegir una relación de aspecto de salida entre 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 16:10, 10:16, 2:1, 1:2, 21:9, 9:21, 3:1, 1:3, 4:1, 1:4, 5:1 y 1:5; la edición de una sola imagen siempre conserva la proporción original.
Capacidad de caracteres suficiente para las instrucciones: la indicación admite hasta 10000 caracteres, lo que permite describir en detalle los requisitos de modificación y citar varios recursos de entrada combinándolos con los números de imagen, facilitando la expresión de instrucciones de edición complejas.
Semilla para reproducir el resultado de la edición: mediante el parámetro seed se fija la semilla aleatoria; la misma semilla con las mismas entradas reproduce el mismo resultado, lo que facilita comparar parámetros o recuperar versiones en una misma tarea de edición.
Casos de uso
- Modificación dirigida de conceptos por parte de diseñadores: se introduce una imagen de diseño conceptual junto con instrucciones de modificación que especifican las partes o atributos a ajustar, y se obtiene la imagen modificada para la iteración de propuestas y su presentación en revisiones.
- Composición de varias imágenes en escenarios de comercio electrónico: se toma una imagen de producto como principal y se combina con hasta tres imágenes de referencia de escenario o estilo para generar, mediante instrucciones, imágenes de estilo de vida que se usan en páginas de detalle del producto o en materiales publicitarios.
- Adaptación de proporciones para materiales de marketing: con varias imágenes de entrada se especifica una proporción de salida como 1:1, 16:9 o 9:16 para generar rápidamente imágenes fijas de marketing adaptadas a distintas ubicaciones de publicación, reduciendo el recorte posterior.
- Sustitución local precisa con máscara: se proporciona una máscara para una sola imagen y solo se modifica el área marcada en blanco, conservando el resto del contenido de la imagen; es adecuada para sustituir partes de un producto o eliminar elementos no deseados.
Limitaciones y recomendaciones de selección
Cada solicitud admite como máximo 4 imágenes de entrada; la edición de una sola imagen con máscara solo admite 1 imagen y la máscara debe tener el mismo tamaño que la imagen original. La indicación tiene un máximo de 10000 caracteres y no se puede enviar si se supera. La relación de aspecto de salida solo se puede elegir entre las 21 proporciones predefinidas; la edición de una sola imagen mantiene siempre la proporción original y no se puede especificar otra. La semilla solo garantiza la reproducibilidad con las mismas entradas y no asegura resultados consistentes entre distintas combinaciones de parámetros.
Novedades
Ver el registro de cambios →- Nuevo modelo FIBO 2.0 edición de imágenes ya disponible
- Nuevo modelo Lanzamiento de la generación de imágenes a partir de texto de FIBO 2.0
Preguntas frecuentes
Ver todas las preguntas →-
Si quiero fijar la composición y reproducir la misma imagen, ¿cómo se configura?
Para reproducir el mismo resultado, basta con fijar el seed y mantener el prompt sin cambios. El seed predeterminado es 5555 y su rango va de 0 a 2147483647; siempre que el seed y el prompt coincidan, la salida será idéntica, mientras que al cambiar el seed se obtiene una composición distinta para el mismo tema.
-
¿Qué relaciones de aspecto se pueden elegir? ¿Cuál es la resolución?
Elige una relación de aspecto de los ajustes predefinidos según la composición; la salida es de aproximadamente 1 megapíxel. Los valores disponibles incluyen 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 16:10, 10:16, 2:1, 1:2, 21:9, 9:21, así como relaciones alargadas como 3:1, 1:3, 4:1, 1:4, 5:1, 1:5; si no se especifica, el valor predeterminado es 1:1.
-
¿Se pueden usar juntos la imagen de referencia y el preajuste de estilo en la generación de imágenes a partir de texto?
No se pueden usar al mismo tiempo; solo se puede elegir una de las dos opciones. En la generación de imágenes a partir de texto, si se pasa style ya no se puede pasar image_url, y viceversa; si quieres definir la escena con una imagen de referencia, renuncia al preajuste de estilo; si quieres una sensación de película, flash duro, bruma o realismo crudo, usa solo el prompt de texto. La edición de imagen a partir de imagen no tiene parámetro de preajuste de estilo; el tono visual se escribe directamente en instruction.
-
¿Qué preajustes de estilo fotográfico están disponibles para la generación de imágenes a partir de texto?
La generación de imágenes a partir de texto admite cuatro estilos fotográficos: Kodak Film, Hard Flash, Hazy Dreamy y Rough Realism. Solo funcionan como un tono fotográfico global opcional y son mutuamente excluyentes con las imágenes de referencia; cuando se necesita un control preciso de la iluminación y del ángulo de cámara, conviene especificarlo en el prompt en lugar de depender únicamente del preajuste. La edición de imagen a imagen no ofrece preajustes de estilo.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl 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-KeystringOpcionalClave 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.
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
modelstringObligatorioValor fijo actual: fibo-2.0/image-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para fibo-2.0/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.
seedintegerOpcionalPredeterminado: 5555min 0max 2147483647Semilla aleatoria, por defecto 5555. La misma semilla con la misma entrada reproduce resultados idénticos.
mask_urlstringOpcionalminLength 1pattern ^https?://URL opcional de imagen de máscara; solo se admite la edición de una única imagen, es decir, image_urls debe contener exactamente 1 imagen; las zonas blancas son las partes a editar, las zonas negras se mantienen intactas, y el tamaño de la máscara debe coincidir con el de la imagen.
image_urlsarrayObligatoriominItems 1maxItems 4Arreglo de URL de imágenes que contiene de 1 a 4 direcciones públicas de imágenes: la primera es la imagen a editar, y las siguientes hasta 3 son imágenes de referencia; en las instrucciones se pueden referenciar en este orden como <image_1>, <image_2>, etc.
Array [ string ]
instructionstringObligatoriominLength 1maxLength 10000Instrucción de texto sobre el contenido de la imagen que se debe modificar.
aspect_ratiostringOpcionalRelación de aspecto de salida, aproximadamente un millón de píxeles; si se omite, se sigue la primera imagen; la edición de una única imagen siempre conserva la relación de aspecto de esa imagen.
1:12:33:23:44:34:55:49:16Mostrar todo (13)Mostrar menos
16:916:1010:162:11:221:99:213:11:34:11:45:11:5callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
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.
urlstringObligatorioObligatorio 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.
finalstoragestringOpcionalPredeterminado: "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.
temppersistentEjemplos 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-2.0/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-2.0/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-2.0/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
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre 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.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
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.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos 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
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripció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"
}
}
} Artículos
Ver todos los artículos →Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Seedream 4.5 ByteDance $0.045 /imagen -
Nano Banana 2 Lite Google $0.033 /imagen -
GPT Image 2.5 OpenAI $0.017 /imagen -
BRIA Product Shot Bria $0.058 /imagen -
GPT Image 2 OpenAI $0.007 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
Recraft Crisp Upscale Recraft $0.004 /imagen -
Google Virtual Try-On Google $0.107 /imagen -
Wan 2.7 Image Alibaba $0.035 /imagen -
Muse Image 1.0 Meta $0.015 per task -
Ideogram V4.5 Ideogram $0.011 /imagen





