curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Idempotency-Key: <unique-operation-key>' \
--data '{
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Idempotency-Key": "<unique-operation-key>"
},
json={
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json",
Accept: "application/json",
"Idempotency-Key": "<unique-operation-key>"
},
body: JSON.stringify({
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01K..."
}
]
}
Muse Image Ext
Generación de imágenes Muse Image Ext
Genera una imagen WebP por solicitud a partir de texto o de hasta 9 imágenes de referencia.
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Idempotency-Key: <unique-operation-key>' \
--data '{
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Idempotency-Key": "<unique-operation-key>"
},
json={
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json",
Accept: "application/json",
"Idempotency-Key": "<unique-operation-key>"
},
body: JSON.stringify({
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01K..."
}
]
}
Esta API es asíncrona. Guarda el ID de tarea tras el envío y consulta
GET /v1/tasks/{task_id} para obtener el estado y los resultados. En la respuesta de envío predeterminada, el ID está en data[0].task_id.curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Idempotency-Key: <unique-operation-key>' \
--data '{
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/images/generations",
headers={
"Authorization": "Bearer <token>",
"Accept": "application/json",
"Idempotency-Key": "<unique-operation-key>"
},
json={
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json",
Accept: "application/json",
"Idempotency-Key": "<unique-operation-key>"
},
body: JSON.stringify({
"model": "muse-image-ext",
"prompt": "A red ceramic cup on a white table, soft studio lighting, product photography, no text",
"aspect_ratio": "1:1",
"n": 1
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01K..."
}
]
}
Cabeceras de solicitud
string
requerido
Usa una APIMart API Key con el formato
Bearer <token>. Tanto el envío como las consultas requieren autenticación con la misma identidad de usuario.string
Muy recomendable. Usa una clave nueva para cada generación independiente (1–191 caracteres ASCII visibles; se recomienda UUID). Sustituye
<unique-operation-key> en los ejemplos. Tras un tiempo de espera agotado o un fallo de red, repite con el mismo endpoint, cuerpo, versión de respuesta y clave. Una vez recibido el ID, consulta únicamente esa tarea.Parámetros de solicitud
string
requerido
Valor fijo:
muse-image-ext.string
requerido
Descripción del contenido deseado en chino o inglés. No puede quedar vacía tras quitar los espacios iniciales y finales. Es obligatoria incluso con imágenes de referencia.
string[]
Hasta 9 entradas de imágenes de referencia no vacías. Admite URL públicas, Data URI (como
data:image/png;base64,...) o base64 sin prefijo. Omite el campo o envía [] para generar solo a partir del texto. Se recomiendan PNG, JPEG y WebP. El servidor debe acceder directamente a las URL sin cookies de inicio de sesión del navegador.El tamaño original combinado de todas las imágenes no debe superar 11 MiB (11.534.336 bytes). Es un límite total, no por imagen. base64 añade tamaño al cuerpo de la solicitud. No envíes URL blob:, rutas locales ni objetos File.string
Admite las siete proporciones siguientes. Si se omite, texto a imagen usa
1:1; con referencias, sigue su composición. Una proporción explícita tiene prioridad. Para selección automática, omite el campo; no envíes "auto".1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3string
Campo de compatibilidad que admite las siete proporciones anteriores o
auto, pero no tamaños en píxeles como 1024x1024. Enviar solo size: "auto" equivale a no indicar proporción. Se recomienda aspect_ratio. Si ambos valores son válidos, aspect_ratio tiene prioridad, pero cada campo se valida por separado: una proporción válida no corrige un size inválido.integer
predeterminado:"1"
Solo un resultado por solicitud. Únicamente se acepta el número
1. Los valores explícitos 0, negativos o mayores que 1 provocan un error.Devuelve una URL WebP. El modelo decide las dimensiones; no se pueden elegir tamaños en píxeles ni niveles 1K / 2K / 4K. No envíes un
resolution no vacío ni campos de duración.Otros parámetros opcionales
string
URL base del backend para las notificaciones. La plataforma elimina las barras finales y añade
/callback: https://your-backend.example/muse pasa a ser https://your-backend.example/muse/callback. Omítela si solo usas consultas periódicas.string
Controla el idioma de los errores del Webhook, no el contenido generado. Valores:
zh, en, ja, ko, ru, fr, de, id, pt, es. No admite etiquetas regionales como zh-CN. Para las consultas, pasa el idioma por separado como parámetro GET.Generación con imágenes de referencia
{
"model": "muse-image-ext",
"prompt": "Keep the cup from the reference image and place it on a wooden cafe table in warm natural light",
"image_urls": [
"https://your-cdn.example/cup.png"
],
"n": 1
}
aspect_ratio para fijarla. Añade más referencias a image_urls, hasta 9 en total.
Respuesta de envío
La respuesta predeterminada es HTTP200, con data como array. submitted significa que la tarea se ha aceptado, no que haya terminado. Guarda data[0].task_id y consulta la tarea.
Versión de respuesta opcional: 2026-07-27
Versión de respuesta opcional: 2026-07-27
Con la cabecera Esta versión no cambia la estructura de las respuestas GET. Si añades esta cabecera, no sigas leyendo el ID de envío en
X-APIMart-Response-Version: 2026-07-27, el envío devuelve HTTP 202. Lee el ID en data.id y la ruta de consulta en data.poll_url.{
"code": 202,
"request_id": "req_example",
"data": {
"id": "task_01K...",
"object": "generation.task",
"type": "image",
"status": "pending",
"progress": 0,
"poll_url": "/v1/tasks/task_01K..."
}
}
data[0].task_id.Consultar estado y resultados
Usa el ID completo recibido al enviar y la misma identidad de usuario.language es opcional y define el idioma de los errores. Consulta todos los campos en Estado de tarea.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/<task_id>?language=es' \
--header 'Authorization: Bearer <token>'
data.status | Acción |
|---|---|
pending / processing | En cola o procesándose; continúa consultando. |
completed | Generación correcta; detén las consultas y lee la URL del resultado. |
failed | Generación fallida; detén las consultas y lee data.error.message. |
unknown / … | Estado incierto. Conserva el ID y limita los reintentos de consulta; no lo consideres un éxito ni regeneres automáticamente. |
data.status. HTTP 200 o progress: 100 por sí solos no indican éxito. Un polling_error durante el procesamiento tampoco es un fallo terminal.
Ejemplo de respuesta de una tarea completada (URL de resultado ilustrativa):
{
"code": 200,
"data": {
"id": "task_01K...",
"status": "completed",
"progress": 100,
"result": {
"images": [
{
"url": [
"https://cdn.example/generated-image.webp"
]
}
]
}
}
}
data es un objeto y url un array de cadenas. El primer resultado está en data.result.images[0].url[0]. Si existe, expires_at indica la caducidad en segundos Unix; guarda los archivos necesarios antes de esa fecha. actual_time mide el tiempo de procesamiento de la tarea, no la duración de reproducción del vídeo.
Limitaciones y gestión de errores
No se admiten vídeos o audios de referencia, máscaras, control del primer/último fotograma, extensiones ni remix.quality no tiene efecto. Omite seed, negative_prompt, width, height, response_format y output_format, ya que no son parámetros de generación de este modelo. async: false no activa la generación síncrona y stream no ofrece un flujo SSE de generación.
HTTP / error.code | Acción |
|---|---|
400 / invalid_request_error | Revisa el prompt, el número de referencias, la proporción, el número de resultados y las especificaciones fijas. |
409 / idempotency_in_progress | Espera según Retry-After y repite la solicitud original con la misma clave de idempotencia. |
409 / idempotency_key_reused | La misma clave se usó para solicitudes diferentes. Corrige la gestión de claves; cada generación independiente necesita una nueva. |
409 / idempotency_result_indeterminate | Detén los reenvíos automáticos y conserva la clave y los datos de la tarea para investigar. |
429 | Espera según Retry-After antes de reintentar. |
200; revisa data.status y data.error.message. Un error de red o 5xx al enviar puede ocurrir después de la aceptación, por lo que no debes reenviar inmediatamente con una clave nueva.