Passer au contenu principal
POST
/
v1
/
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.1", "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-mjv81",
  "model": "mj-v8.1",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}
Midjourney dispose d’un système de modération de contenu intégré. Si certaines images générées sont filtrées par la modération, les crédits consommés pour cette requête ne seront pas remboursés. Veuillez vous assurer que vos prompts 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.1
requis

Nom du modèle

Options disponibles:
mj-v8.1
​
prompt
string
requis

Prompt, prend en charge toute la syntaxe native des paramètres Midjourney V8.1 (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
Maximum string length: 8192
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

​
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, échouée ou annulé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

​
id
string

ID de la tâche

Exemple:

"task-unified-1757165031-mjv81"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"mj-v8.1"

​
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

​
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