21:9 高调光晕宽幅：左侧留白，右侧悬浮半透明玻璃渲染面板与光带轨道，冷蓝、珊瑚粉与暖金渐变，模型名以玻璃蚀刻发光立体字呈现。

Muse Image 1.0

muse-image-1.0/image-to-image

Modelo de generación y edición de imágenes de razonamiento de Meta que primero descompone las indicaciones complejas y luego las renderiza; puede combinar varias imágenes de referencia y apoyarse en la búsqueda web para garantizar la precisión factual

muse-image-1.0/image-to-image muse-image-1.0/text-to-image

Probar muse-image-1.0/image-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

muse-image-1.0/image-to-image per task

Precio unitario	$0.015

Descripción general

muse-image-1.0/image-to-image es un modelo de generación y edición de imágenes impulsado por imágenes de referencia, lanzado por Meta, que se invoca mediante la interfaz unificada de HiAPI.ai. Toma como entrada una o varias imágenes de referencia y, junto con un prompt de texto, realiza la generación de la escena, la sustitución de elementos y la reescritura de estilo; además, descompone y planifica el diseño de instrucciones complejas de varios segmentos antes de renderizar. Es adecuado para desarrolladores que necesitan usar material existente como imagen base y buscan un alto cumplimiento del prompt y eficiencia en la producción por lotes; puede emplearse en flujos como variantes de material, imágenes de escenas de productos y composición personalizada.

Aspectos destacados

Flujo de generación con razonamiento previo a la renderización: antes de renderizar, descompone prompts de varios segmentos y planifica el diseño, lo que reduce la probabilidad de que las instrucciones complejas se pierdan en una única generación hacia adelante.
Generación y edición en un mismo modelo: la fusión de imágenes de referencia y la reescritura según instrucciones no requieren encadenar herramientas de edición adicionales, lo que reduce los pasos de invocación.
Envío de varias imágenes de referencia en una sola llamada: admite hasta 10 imágenes de referencia, y en el prompt se puede asignar a cada imagen un rol de sujeto, estilo o composición.
Especificaciones de salida controladas directamente por parámetros: se puede especificar la relación de aspecto y el formato de salida jpeg, png o webp, lo que facilita la integración con la cadena de material posterior.

Descripción de capacidades

Edición de imágenes basada en imágenes de referencia: toma como entrada una imagen de referencia más un prompt de texto, y modifica o conserva el contenido de la imagen según el prompt; es adecuado para ajustes dirigidos sobre material existente en lugar de generar desde cero.

Fusión de varias imágenes: una sola solicitud puede incluir de 1 a 10 imágenes de referencia, y en el prompt se puede indicar a cada imagen un rol de sujeto, estilo o composición, para tareas de composición.

Ejecución descompuesta de prompts complejos: planifica primero las descripciones de varios segmentos y luego renderiza, lo que facilita que los prompts con múltiples sujetos y requisitos de diseño se implementen por completo.

Control de especificaciones de salida: admite nueve relaciones de aspecto, de 1:1 a 21:9, y permite elegir el formato jpeg, png o webp, generando directamente según las necesidades de publicación o almacenamiento.

Casos de uso

Equipos de publicidad y campañas: generación por lotes de variantes a partir de material existente: subir una imagen base de marca y reescribir la escena y la proporción según el prompt del canal, produciendo varios conjuntos de material para pruebas A/B y distribución multicanal.
Operaciones de comercio electrónico: transformación escénica de imágenes de producto: usar la foto real del producto como referencia, indicar en el prompt la sustitución del fondo y la escena, y generar imágenes de catálogo o de escena para la página de detalles del producto.
Composición personalizada: integrar fotos de usuarios en una nueva escena: usar la foto subida por el usuario como imagen de referencia para componer una escena temática, produciendo imágenes personalizadas para páginas de campaña o para compartir en redes sociales.

Limitaciones y recomendaciones de selección

La información pública no revela detalles técnicos como la arquitectura del modelo ni la resolución de salida, por lo que los resultados generados deben evaluarse según su efecto real. El razonamiento de varios pasos añade latencia adicional, por lo que no es adecuado para escenarios extremadamente sensibles al tiempo de respuesta; la salida se limita a imágenes y no incluye vídeo ni audio. Si la tarea solo requiere generar imágenes desde cero a partir de texto, sin imágenes de referencia, se puede optar por la línea de texto a imagen de la misma familia; si se necesita generación de vídeo o una latencia menor, conviene considerar otros modelos.

Preguntas frecuentes

Ver todas las preguntas →

¿Cómo elegir entre generación de imágenes a partir de texto y edición de imágenes?

Cuando solo se dispone de texto y se parte de cero, elige la generación de imágenes a partir de texto; cuando necesites reutilizar un sujeto o un diseño ya existente, elige la edición de imágenes y proporciona una imagen de referencia.
¿Cuántas imágenes se pueden obtener cada vez?

Cada tarea devuelve una imagen, no hay opción de cantidad. Si necesita comparar otra composición, ajuste el prompt y envíe una nueva tarea.
¿Se puede elegir 1K, 2K o 4K?

Esta entrada no ofrece niveles de resolución. Tú eliges la relación de aspecto y el modelo determina el tamaño en píxeles, normalmente unos 2.5MP; consulta las dimensiones reales del archivo descargado.
¿Qué formatos de archivo se pueden elegir?

Se puede elegir JPEG, PNG o WebP; si no se selecciona ninguno, se usa WebP. Elija según las necesidades posteriores de materiales web o herramientas de diseño.

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: muse-image-1.0/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 1maxLength 5000

Indicación de texto que describe la imagen que se desea generar, o explica qué contenido de la imagen de referencia debe modificarse y conservarse; al usar imágenes de referencia, se debe indicar en ella el sujeto, el estilo o el rol compositivo de cada imagen.

image_urlsarrayObligatoriominItems 1maxItems 10

Arreglo de imágenes de referencia, cuyos elementos son direcciones de imagen que proporcionan las referencias necesarias para la generación de imagen a partir de imagen; se recomienda indicar en el prompt el sujeto, el estilo o el rol compositivo correspondiente a cada imagen.

Array [ string ]

aspect_ratiostringOpcional

Relación de aspecto de la imagen de salida; solo determina la proporción, no especifica dimensiones exactas en píxeles.

Opciones:1:14:33:416:99:163:22:321:9

Mostrar todo (1)

9:21

output_formatstringOpcionalPredeterminado: "webp"

Formato de archivo de la imagen descargada; por defecto, webp.

Opciones:jpegpngwebp

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": "muse-image-1.0/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "output_format": "webp"
  }
}'

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: "muse-image-1.0/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "output_format": "webp"
    }
  }),
});
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": "muse-image-1.0/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "output_format": "webp"
        }
    },
)
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"
    }
  }
}