curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: mj-v8.2",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Midjourney V8.2

Midjourney V8.2 Génération d'images

Le modèle Midjourney V8.2 prend en charge la génération d’images de haute qualité via des prompts en langage naturel. Le mode Fast renvoie 4 images par génération ; le mode Draft renvoie 24 images d’esquisse légères en 512 px en une seule exécution
Prend en charge le texte-vers-image et l’image-vers-image (en référençant des URL d’images dans le prompt)
Les URL d’images d’entrée doivent être accessibles publiquement et récupérables en environ 10 secondes ; le fournisseur télécharge les images de manière synchrone à la création de la tâche et renvoie 400 s’il n’y parvient pas. Les hébergeurs d’images situés hors de Chine continentale (imgur, ibb, raw.githubusercontent, pinimg, picsum) échouent en pratique. Hébergez les images sur un CDN rapide ou utilisez le téléversement de fichiers de la plateforme
Points forts de V8.2 : amélioration de l’esthétique et de la qualité d’image par rapport à V8.1, niveau de détail défini avec le paramètre natif --quality / --q (1–4, 4 = mode haute qualité) dans le prompt sans surcoût, et sortie 2K native (quality=hd). Turbo n’est pas disponible sur V8.2 (le fournisseur documente V8 comme ne prenant pas en charge turbo)
La référence de style (--sref) est prise en charge ; --oref / --cref ne sont pas pris en charge sur V8.2 et sont rejetés par le fournisseur, voir le guide des paramètres de prompt
Les paramètres de prompt non pris en charge par le fournisseur sont transmis tels quels : la tâche échoue avec une erreur de paramètre (invalid_parameters) et les crédits réservés sont remboursés (ils ne sont plus ignorés silencieusement)
Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour effectuer une requête
Les liens d’images générées sont valides pendant 30 jours, veuillez les sauvegarder rapidement
Délai d’expiration : environ 20 minutes
Note sur les paramètres : cette interface fonctionne sur V8.2 et ne prend pas en charge niji ; définissez le mode de vitesse via model_params.speed et la qualité de sortie via le paramètre de premier niveau quality ; le niveau de détail s’écrit dans le prompt sous la forme --quality / --q (1–4) et est transmis tel quel
mj-v8.2-edit / mj-v8.2-upload-paint sont des éditions sur canevas (img_pos + masque). Le point de terminaison d’édition par instructions du fournisseur (--edit, jusqu’à 4 images de référence) n’est pas encore exposé sur cette interface et est en cours de planification

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: mj-v8.2",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Midjourney dispose d’un système de modération de contenu intégré. Chaque image est modérée individuellement : les images filtrées n’apparaissent pas dans les résultats et les autres images sont livrées normalement, vous pouvez donc recevoir moins d’images que d’habitude. Si au moins une image est validée, la tâche est completed et facturée normalement ; si toutes les images sont filtrées, la tâche se termine en failed et les crédits réservés sont intégralement remboursés. Veuillez vous assurer que vos prompts et vos images de référence respectent les directives de contenu.

Autorisations

Authorization

string

header

requis

Toutes les interfaces nécessitent une authentification par Bearer Token

Obtenir une clé API :

Visitez la page de gestion des clés API pour obtenir votre clé API

Ajoutez dans l'en-tête de la requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

défaut:mj-v8.2

requis

Nom du modèle

Options disponibles:

mj-v8.2

prompt

string

requis

Prompt, prend en charge toute la syntaxe native des paramètres Midjourney V8.2 (ex. --ar 16:9 --s 500).

Image-vers-image : Placez les URL d'images au début du prompt. Formats pris en charge : .png, .gif, .webp, .jpg, .jpeg

Règles image-vers-image :

1 image + pas de texte = invalide (retournera une erreur)
1 image + description textuelle = valide
2+ images + pas de texte = valide
2+ images + description textuelle = valide

Paramètres non pris en charge : les paramètres non pris en charge par le fournisseur (par ex. --oref, --cref, --stop, --bs) sont transmis et explicitement rejetés par le fournisseur : la tâche échoue avec une erreur de paramètre (invalid_parameters) et les crédits réservés sont remboursés. --v / --version / --niji ainsi que les paramètres de vitesse / hd sont retirés et contrôlés via les paramètres de l'API ; --quality / --q (1–4) est transmis tel quel.

Maximum string length: 2048

Exemple:

"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"

quality

enum<string>

défaut:standard

Qualité de sortie

standard : résolution standard (par défaut), multiplicateur 1x
hd : sortie HD native, multiplicateur 1.5x. Mutuellement exclusif avec speed: draft

Note de tarification : le multiplicateur de qualité est combiné (multiplié) avec le multiplicateur speed.

Options disponibles:

standard,

hd

model_params

object

Paramètres du modèle

Show child attributes

callback_url

string<uri>

Adresse de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

Déclenché lorsque la tâche est terminée ou échouée
Envoyé après la confirmation de facturation

Restrictions de sécurité :

Seul le protocole HTTPS est pris en charge
Les rappels vers les adresses IP privées sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

Délai d'expiration : 10 secondes
Jusqu'à 3 tentatives après un échec (respectivement 1s/2s/4s après l'échec)
Le format du corps de la réponse de rappel est identique à celui de l'interface de requête de tâche
Un code de statut 2xx est considéré comme un succès, tout autre code de statut déclenche une nouvelle tentative

Exemple:

"https://your-domain.com/webhooks/image-task-completed"

Réponse

Tâche créée avec succès

created

integer

Horodatage de création de la tâche

Exemple:

1757165031

string

ID de la tâche

Exemple:

"task-unified-1757165031-mjv82"

model

string

Nom du modèle réellement utilisé

Exemple:

"mj-v8.2"

object

enum<string>

Type d'objet de la tâche

Options disponibles:

image.generation.task

progress

integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100

Exemple:

0

status

enum<string>

Statut de la tâche

Options disponibles:

pending,

processing,

completed,

failed

Exemple:

"pending"

task_info

object

Informations de tâche asynchrone

Show child attributes

type

enum<string>

Type de sortie de la tâche

Options disponibles:

text,

image,

audio,

video

Exemple:

"image"

usage

object

Informations d'utilisation et de facturation

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Midjourney V8.2 Génération d'images

Autorisations

Toutes les interfaces nécessitent une authentification par Bearer Token

Corps

Réponse