Base URL: https://api.apimart.aiAuth: Authorization: Bearer <token>Las nuevas rutas /v1/midjourney/... inyectan model=midjourney automáticamente; no necesita pasar model en el body.
Inicio rápido
# 1. Enviar un trabajo Imagine
curl -X POST https://api.apimart.ai/v1/midjourney/generations \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"prompt": "a cute cat, watercolor style --ar 16:9"}'
# 2. Sondear la API unificada de tareas hasta status=completed
curl https://api.apimart.ai/v1/tasks/task_01JWXXXX \
-H "Authorization: Bearer <token>"
# 3. Ampliar la imagen 1
curl -X POST https://api.apimart.ai/v1/midjourney/generations/upscale \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"task_id": "task_01JWXXXX", "index": 1}'
Resumen de la API
Vea los campos completos, ejemplos y notas de cada función en su subpágina correspondiente.
| Función | Ruta | Documentación |
|---|
| Texto a imagen (por defecto) | POST /v1/midjourney/generations | Imagine |
| Texto a imagen (explícito) | POST /v1/midjourney/generations/imagine | Imagine |
| Mezcla de varias imágenes | POST /v1/midjourney/generations/blend | Blend |
| Imagen a texto | POST /v1/midjourney/generations/describe | Describe |
| Edición de imagen | POST /v1/midjourney/generations/edits | Edits |
| Ampliar una baldosa | POST /v1/midjourney/generations/upscale | Upscale |
| Variación | POST /v1/midjourney/generations/variation | Variation |
| Variación fuerte | POST /v1/midjourney/generations/high-variation | High Variation |
| Variación sutil | POST /v1/midjourney/generations/low-variation | Low Variation |
| Regenerar | POST /v1/midjourney/generations/reroll | Reroll |
| Zoom out | POST /v1/midjourney/generations/zoom | Zoom |
| Paneo | POST /v1/midjourney/generations/pan | Pan |
| Inpaint (Vary Region) | POST /v1/midjourney/generations/inpaint | Inpaint |
| Modal (parámetros) | POST /v1/midjourney/generations/modal | Modal |
| Imagen a video | POST /v1/midjourney/generations/video | Video |
| Remix (fuerte / sutil) | POST /v1/midjourney/generations/remix-strong · /remix-subtle | Remix |
| Consulta de tareas | GET /v1/tasks/{task_id} · /v1/midjourney/{task_id} | Consultar tarea |
Flujo de extremo a extremo
Errores
{
"error": {
"type": "invalid_request_error",
"message": "prompt is required"
}
}
Errores comunes
| HTTP | type | Significado |
|---|
| 400 | invalid_request_error | Parámetros inválidos |
| 401 | authentication_error | API Key inválida |
| 402 | payment_required | Saldo insuficiente |
| 404 | not_found | Tarea no encontrada |
| 429 | rate_limit_error | Límite de tasa excedido |
| 500 | internal_error | Error del servidor |
Fallos de tarea
Valores comunes de fail_reason:
Banned prompt detected — contenido prohibido en el promptTask timeout — timeout (auto-reembolso tras 30+ minutos)No available upstream — servicio temporalmente no disponible, reintente más tarde
Facturación
El nombre unificado del modelo para las nuevas rutas MJ es midjourney. Las claves de facturación se generan a partir de action, version y speed. El orden de match habitual es:
midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney
| Acción | Nombre de facturación | Notas |
|---|
| Imagine | midjourney@imagine[-version][-speed] | Texto a imagen / guiado por imagen |
| Blend | midjourney@blend[-speed] | Mezcla de varias imágenes |
| Describe | midjourney@describe[-speed] | Imagen a texto |
| Edits | midjourney@edits[-speed] | Edición de imagen |
| Upscale | midjourney@upscale[-version][-speed] | Ampliación |
| Variation | midjourney@variation[-version][-speed] | Variación |
| High Variation | midjourney@high_variation[-version][-speed] | Variación fuerte |
| Low Variation | midjourney@low_variation[-version][-speed] | Variación sutil |
| Reroll | midjourney@reroll[-version][-speed] | Regeneración |
| Zoom | midjourney@zoom[-version][-speed] | Zoom out / outpaint |
| Pan | midjourney@pan[-version][-speed] | Pan outpaint |
| Inpaint | midjourney@inpaint[-version][-speed] | Entrada de inpaint |
| Modal | midjourney@modal[-speed] | Parámetros de seguimiento de inpaint |
| Video | midjourney@video / midjourney@video-720p | Imagen a video, cobrado × batch_size |
| Remix Strong | midjourney@remix_strong[-speed] | Reshape fuerte (solo v8.1 / v8.2) |
| Remix Subtle | midjourney@remix_subtle[-speed] | Reshape sutil (solo v8.1 / v8.2) |
speed=relax u omitido no añade sufijo de speed; fast / turbo añaden el sufijo correspondiente.- Las versiones principales se normalizan a
v8.2, v8.1, v7, v6.1, v5.2, v5.1.
niji=true + version=7/6 se normaliza a niji7 / niji6.
Vea el precio en la consola. Las tareas fallidas se reembolsan completamente.