Muse Image

Muse Image es el modelo de imágenes de Meta Superintelligence Labs. Cada solicitud crea una imagen a partir de un prompt o de un prompt con hasta 9 imágenes de referencia, en una de siete relaciones de aspecto. Envía la solicitud, conserva el ID de tarea devuelto y lee la imagen terminada en la tarea. Las imágenes de referencia se envían como URL.

ID de modelo

Consulta los precios actuales en la página del modelo.

Ejemplo rápido

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/images/generations

La respuesta es una tarea ({"id": "task_...", "status": "processing"}), no la imagen terminada. Consulta GET /v1/tasks/{task_id} para obtener el resultado. Guarda las claves de API en código del servidor. Las referencias van en la misma solicitud mediante image_urls; /v1/images/edits no se usa para este modelo.

Parámetros

Los campos fuera de esta lista se descartan antes de reenviar la solicitud; nunca causan errores ni cambian la salida. No hay ajustes de resolución, semilla, prompt negativo, máscara ni formato de salida. callback_url no está disponible; consulta la tarea.

Imágenes de referencia

Pasa hasta 9 imágenes en image_urls e indica en prompt qué conservar y qué cambiar. Muse Image las usa como referencias para una nueva imagen; si omites aspect_ratio, el resultado sigue su forma.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

Entradas multimedia

Cada referencia es una URL pública HTTP(S). No se aceptan URI de datos Base64: sube el archivo a tu propio almacenamiento y pasa su URL. Usa imágenes PNG, JPEG o WebP; los archivos originales de todas las referencias deben sumar 11 MB o menos. Un conjunto que supera ese límite falla después de aceptarse y no se cobra.

Criterios de precio

Consulta las tarifas actuales en la sección de precios del modelo. Muse Image tiene un precio por imagen:

cost = price per image × 1

Las solicitudes solo de texto y con referencias cuestan lo mismo, al igual que todas las relaciones de aspecto. El importe reservado al aceptar la tarea es el que se cobra. Consulta los cargos finales en el historial de uso de tu cuenta. Las tareas fallidas no se cobran.

Esquema de salida

El envío devuelve la tarea:

{"id": "task_...", "model": "muse-image", "status": "processing", "created_at": 1789689600}

Consultar la tarea

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Consulta cada 10–20 segundos hasta que status sea completed o failed. Un timeout de red durante el sondeo no significa que la generación haya fallado: conserva el ID de tarea y sigue consultándolo. No crees otra tarea para comprobar el progreso.

Tarea completada

{
  "id": "task_...",
  "model": "muse-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

La imagen se entrega como WebP, el formato propio del modelo; no hay ajuste de formato de salida. El modelo determina el tamaño en píxeles. En nuestras pruebas, una solicitud solo de texto llegó en 1600 × 1600, 16:9 en 2048 × 1152, 3:4 en 1344 × 1792 y 9:16 en 1152 × 2048, unos 50–180 segundos después del envío.

Errores

Las solicitudes rechazadas antes de crear una tarea devuelven un error HTTP con un objeto error y no se cobran. Una tarea que falla después de aceptarse devuelve HTTP 200 al consultarla, con status: "failed" y un objeto error.

Consulta el catálogo común de errores para ver códigos, estados HTTP y recomendaciones para reintentos.

{
  "id": "task_...",
  "model": "muse-image",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si el propio envío agota el tiempo de espera, consulta tus tareas antes de volver a enviarlo: la primera solicitud podría haberse aceptado.

Consejos

• Nombra el sujeto, el lugar, la luz y el encuadre; Muse Image sigue fielmente un encargo concreto.
• Con referencias, indica exactamente qué debe mantenerse, como el color o la forma del producto.
• Omite aspect_ratio para seguir la forma de una referencia; defínelo para recortar según el canal.
• Añade sin texto, sin logotipos para evitar marcas inventadas.

Relacionado

• Playground y precios de Muse Image
• Referencia de la API de Muse Video
• Descargar OpenAPI
• Markdown para copiar