APIMart
Imagen

Muse Image API

Crea imágenes con Muse Image API a partir de un prompt o de hasta nueve referencias. Elige una proporción o sigue la de las referencias y obtén una imagen WebP mediante la API de tareas.

Generación de imágenes

Aspectos destacados del servicio

  • Descuentos Oficiales
  • Pago por uso
  • Rápido y baja latencia
Input
Imagen de referencia

Opcional: hasta 9 imágenes, 11 MiB en total. Automático sigue la relación de aspecto de referencia.

Salida

Aún no hay generaciones.

Precios de Muse Image API

Precios transparentes sin tarifas ocultas. Paga solo por lo que uses.

VariantePrecio OroPrecio actualPrecio PlatinoPrecio DiamantePrecio oficialTu ahorro
muse-image-ext0.048Credits(~$0.0048)/img0.0456Credits(~$0.0046)/img0.0432Credits(~$0.0043)/img0.06Credits(~$0.006)/img20%

* Los costos reales dependen del resultado final.

Crea con Muse Image API

Crea imágenes con Muse Image API a partir de un prompt o de hasta nueve referencias. Elige una proporción o sigue la de las referencias y obtén una imagen WebP mediante la API de tareas.

Funciones de Muse Image API

Modos de generación, requisitos de entrada y especificaciones de salida.

Texto a imagen con Muse Image API

Describe el sujeto, el entorno, la composición y la luz. Envía el prompt sin referencias para generar desde texto.

Imágenes de referencia con Muse Image API

Añade hasta nueve imágenes mediante URL, Data URI o base64. El tamaño original combinado no puede superar 11 MiB.

Siete proporciones para Muse Image

Elige 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 o 2:3. Automático omite aspect_ratio y sigue la proporción de las referencias cuando las hay.

Una imagen WebP con Muse Image Model

Cada solicitud genera una imagen. El modelo decide las dimensiones; no se pueden elegir tamaños en píxeles ni niveles de resolución.

Usa el modelo muse-image-ext

Envía el identificador completo a /v1/images/generations para iniciar una tarea de generación.

Tareas asíncronas con Muse Image API

Envía una vez, guarda el ID de tarea y consulta su estado. Tras una interrupción, reutiliza la misma clave de idempotencia y el mismo cuerpo de solicitud.

Precios de Muse Image API

Comprueba los precios actuales de tu cuenta antes de generar. El coste final de la tarea y el extracto determinan el cargo. Cada solicitud se cobra por imagen.

Obtén y guarda resultados de Muse Image

Lee la URL cuando el estado sea completed. Si la respuesta incluye expires_at, descarga o archiva el archivo antes de ese plazo.

Casos de uso de Muse Image API

Prepara un brief acorde con el proyecto y revisa el resultado entregado.

Escenas de producto con Muse Image API

Describe el entorno, la luz y la composición, con referencias si hacen falta. Revisa los detalles del producto antes de publicarlo.

Conceptos de campaña con Muse Image

Explora sujetos, paletas y estilos para una campaña y compara las imágenes con el brief.

Imágenes editoriales con Muse Image API

Convierte el tema de un artículo en un brief visual y deja espacio para el texto añadido durante la maquetación.

Diseño con referencias mediante muse-image-ext

Combina texto y referencias para describir la escena y revisa los detalles esenciales del diseño.

Imágenes sociales con Muse Image

Elige formato vertical, cuadrado u horizontal según el destino y prepara la imagen final para publicarla.

Herramientas de imagen con Muse Image API

Integra prompts, seguimiento de tareas y obtención de imágenes en tu aplicación. Guarda las claves API en el servidor.

Cómo obtener una clave Muse Image API y empezar

Crea tu clave, prepara el brief y organiza tus resultados.

1

Obtén tu clave Muse Image API

Inicia sesión en APIMart y crea una clave en API Keys. Guárdala en tu servidor, fuera del código del navegador y de repositorios públicos.

2

Prepara un brief claro

Describe el resultado deseado y su contexto. Guarda el brief junto con la solicitud para comparar revisiones.

3

Revisa e integra el resultado

Compara el resultado con tu brief antes de usarlo. Organiza los recursos elegidos para la siguiente fase de producción.

Ejemplos e integración de Muse Image API

Envía muse-image-ext a /v1/images/generations, guarda el ID y consulta el resultado con GET /v1/tasks/{task_id}.

  1. 1

    Autentica las solicitudes de Muse Image API

    Guarda la clave en el servidor y envía Authorization: Bearer <key>. Crea un Idempotency-Key para cada nueva generación.

  2. 2

    Envía una tarea muse-image-ext

    Haz POST de model y prompt a /v1/images/generations y guarda data[0].task_id de la respuesta predeterminada. Al repetir un envío interrumpido, conserva la clave y el cuerpo.

  3. 3

    Obtén el resultado de Muse Image

    Consulta GET /v1/tasks/{task_id} hasta completed o failed. Lee data.result.images[0].url[0] al completarse o data.error.message si falla. Un tiempo de espera local agotado no es un fallo de la tarea.

    Consulta la referencia de Muse Image API para ver los detalles de solicitudes y respuestas.

POST /v1/images/generations
IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "muse-image-ext",
    "prompt": "A red ceramic cup on a white table, soft studio lighting, product photograph, no text",
    "n": 1,
    "aspect_ratio": "1:1"
  }'

Parámetros de Muse Image API

ParámetroTipoObligatorioPredeterminadoDescripción
modelstringObligatorioPredeterminado: —Identificador obligatorio: muse-image-ext.
promptstringObligatorioPredeterminado: —Texto no vacío tras quitar los espacios de los extremos. Admite inglés y chino; obligatorio incluso con referencias.
image_urlsstring[]OpcionalPredeterminado: —Hasta nueve URL de imagen, Data URI o cadenas base64; tamaño original total de hasta 11 MiB. Omite el campo sin referencias.
aspect_ratiostringOpcionalPredeterminado: —1:1, 16:9, 9:16, 4:3, 3:4, 3:2 o 2:3. En automático, omite el campo sin enviar "auto". Sin referencias: 1:1; con ellas: su proporción.
nintegerOpcionalPredeterminado: 1Solo el número 1. Un resultado por solicitud.
nsfw_checkbooleanOpcionalPredeterminado: falseActiva la moderación previa al envío. Un envío correcto no garantiza superar todas las comprobaciones.

Explora las API de Muse

Elige la página de Muse que corresponda al contenido de tu proyecto.

Muse Video API

Preguntas sobre Muse Image API

¿Qué es Muse Image API?

Genera imágenes desde texto o referencias mediante APIMart. El modelo muse-image-ext devuelve una imagen WebP por tarea asíncrona.

¿Qué ID de modelo utiliza Muse Image API?

Usa muse-image-ext completo, incluido -ext, en el campo model de la solicitud.

¿Cómo consigo una clave de Muse Image API?

Inicia sesión en APIMart y crea una clave en API Keys. Guárdala en el servidor y envía Authorization: Bearer <key> al crear y consultar tareas.

¿Cuántas referencias admite Muse Image?

De cero a nueve imágenes, con un tamaño original total máximo de 11 MiB. Envía URL, Data URI o base64 en image_urls; el prompt sigue siendo obligatorio.

¿Qué proporciones admite Muse Image API?

1:1, 16:9, 9:16, 4:3, 3:4, 3:2 y 2:3. En automático se omite aspect_ratio: sigue la proporción de las referencias o usa 1:1 cuando no hay ninguna.

¿Puedo elegir la resolución de Muse Image?

No. El modelo determina las dimensiones y devuelve WebP. No envíes un nivel de resolución ni un tamaño en píxeles como 1024x1024.

¿Muse Image API genera varias imágenes o admite máscaras?

Cada solicitud genera una imagen y n solo acepta el número 1. No se admiten máscaras ni referencias de vídeo o audio.

¿Qué pasa si Muse Image API supera la espera de la página?

Guarda el ID y consulta la tarea después. Un tiempo de espera agotado en el navegador no cancela la tarea del servidor; no generes de nuevo automáticamente.

¿Cómo se calculan los precios de Muse Image API?

Comprueba los precios actuales de tu cuenta antes de generar. El coste final de la tarea y el extracto determinan el cargo. Cada solicitud se cobra por imagen.

¿Puedo conservar los resultados de Muse Image?

Descarga o archiva los archivos. Si se incluye expires_at, hazlo antes de ese plazo; un enlace caducado no debe activar otra generación de pago automáticamente.