Base URL : https://api.apimart.aiAuth : Authorization: Bearer <token>Les nouvelles routes /v1/midjourney/... injectent automatiquement model=midjourney ; vous n’avez pas besoin de passer model dans le body.
Démarrage rapide
# 1. Soumettre une tâche 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. Sondez l'API unifiée des tâches jusqu'à status=completed
curl https://api.apimart.ai/v1/tasks/task_01JWXXXX \
-H "Authorization: Bearer <token>"
# 3. Agrandir l'image 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}'
Aperçu de l’API
Les champs complets, exemples et notes de chaque fonction se trouvent sur la page dédiée correspondante.
| Fonction | Chemin | Documentation |
|---|
| Texte vers image (entrée par défaut) | POST /v1/midjourney/generations | Imagine |
| Texte vers image (entrée explicite) | POST /v1/midjourney/generations/imagine | Imagine |
| Fusion multi-images | POST /v1/midjourney/generations/blend | Blend |
| Image vers texte | POST /v1/midjourney/generations/describe | Describe |
| Édition d’image | POST /v1/midjourney/generations/edits | Edits |
| Agrandir une tuile | POST /v1/midjourney/generations/upscale | Upscale |
| Variation | POST /v1/midjourney/generations/variation | Variation |
| Variation forte | POST /v1/midjourney/generations/high-variation | High Variation |
| Variation subtile | POST /v1/midjourney/generations/low-variation | Low Variation |
| Régénérer | POST /v1/midjourney/generations/reroll | Reroll |
| Zoom out | POST /v1/midjourney/generations/zoom | Zoom |
| Pan | POST /v1/midjourney/generations/pan | Pan |
| Inpaint | POST /v1/midjourney/generations/inpaint | Inpaint |
| Modal (paramètres) | POST /v1/midjourney/generations/modal | Modal |
| Image vers vidéo | POST /v1/midjourney/generations/video | Video |
| Remix (fort / subtil) | POST /v1/midjourney/generations/remix-strong · /remix-subtle | Remix |
| Consulter une tâche | GET /v1/tasks/{task_id} · /v1/midjourney/{task_id} | Consulter une tâche |
Voir aussi : Bonnes pratiques (polling / réessais / dépannage) · Workflows de bout en bout (parcours curl + wrappers client)
Flux de bout en bout
Erreurs
{
"error": {
"type": "invalid_request_error",
"message": "prompt is required"
}
}
Erreurs courantes
| HTTP | type | Signification |
|---|
| 400 | invalid_request_error | Paramètres invalides |
| 401 | authentication_error | Clé API invalide |
| 402 | payment_required | Solde insuffisant |
| 404 | not_found | Tâche non trouvée |
| 429 | rate_limit_error | Limite de taux atteinte |
| 500 | internal_error | Erreur serveur |
Échecs de tâche
Valeurs courantes de fail_reason :
Banned prompt detected — contenu interdit dans le prompt
Task timeout — timeout (remboursement auto après 30+ minutes)
No available upstream — service temporairement indisponible, réessayez plus tard
Facturation
Le nom unifié du modèle pour les nouvelles routes MJ est midjourney. Les clés de facturation sont générées à partir d’action, version et speed. L’ordre de match habituel :
midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney
| Action | Nom de facturation | Notes |
|---|
| Imagine | midjourney@imagine[-version][-speed] | Texte vers image / guidé par image |
| Blend | midjourney@blend[-speed] | Fusion multi-images |
| Describe | midjourney@describe[-speed] | Image vers texte |
| Edits | midjourney@edits[-speed] | Édition d’image |
| Upscale | midjourney@upscale[-version][-speed] | Agrandissement |
| Variation | midjourney@variation[-version][-speed] | Variation |
| High Variation | midjourney@high_variation[-version][-speed] | Variation forte |
| Low Variation | midjourney@low_variation[-version][-speed] | Variation subtile |
| Reroll | midjourney@reroll[-version][-speed] | Régénération |
| Zoom | midjourney@zoom[-version][-speed] | Zoom out / outpaint |
| Pan | midjourney@pan[-version][-speed] | Pan outpaint |
| Inpaint | midjourney@inpaint[-version][-speed] | Entrée inpaint |
| Modal | midjourney@modal[-speed] | Paramètres de suivi inpaint |
| Video | midjourney@video / midjourney@video-720p | Image vers vidéo, facturé × batch_size |
| Remix Strong | midjourney@remix_strong[-speed] | Reshape fort (v8 / v8.1 uniquement) |
| Remix Subtle | midjourney@remix_subtle[-speed] | Reshape subtil (v8 / v8.1 uniquement) |
Notes :
speed=relax ou omis n’ajoute pas de suffixe de speed ; fast / turbo ajoutent le suffixe correspondant.
- Les versions principales se normalisent à
v8.1, v7, v6.1, v5.2, v5.1.
niji=true + version=7/6 se normalise à niji7 / niji6.
Voir la tarification de la console. Les tâches échouées sont entièrement remboursées.