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-v7",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "model_params": {
    "speed": "fast"
  }
}
'
{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv7",
  "model": "mj-v7",
  "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 necessitent une authentification par Bearer Token##

Obtenir une cle API :

Visitez la page de gestion des cles API pour obtenir votre cle API

Ajoutez dans l'en-tete de la requete :

Authorization: Bearer YOUR_API_KEY

Corps

application/json
​
model
enum<string>
défaut:mj-v7
requis

Nom du modèle

Options disponibles:
mj-v7
​
prompt
string
requis

Prompt, prend en charge toute la syntaxe native des parametres Midjourney V7 (ex. --ar 16:9 --s 500).

Image-vers-image : Placez les URLs d'images au debut du prompt. Formats supportes : .png, .gif, .webp, .jpg, .jpeg

Regles 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"

​
model_params
object

Paramètres du modèle

​
callback_url
string<uri>

Adresse de rappel HTTPS apres l'achevement de la tache

Moment du rappel :

  • Declenche lorsque la tache est terminee (completed), echouee (failed) ou annulee (cancelled)
  • Envoye apres la confirmation de facturation

Restrictions de securite :

  • Seul le protocole HTTPS est pris en charge
  • Les rappels vers les adresses IP privees 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 depasser 2048 caracteres

Mecanisme de rappel :

  • Delai d'expiration : 10 secondes
  • Jusqu'a 3 tentatives apres un echec (respectivement 1s/2s/4s apres l'echec)
  • Le format du corps de la reponse de rappel est identique a celui de l'interface de requete de tache
  • Un code de statut 2xx de l'adresse de rappel est considere comme un succes, tout autre code de statut declenche 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

Exemple:

1757165031

​
id
string

ID de la tâche

Exemple:

"task-unified-1757165031-mjv7"

​
model
string

Nom du modèle utilisé

Exemple:

"mj-v7"

​
object
enum<string>

Type de tâche

Options disponibles:
image.generation.task
​
progress
integer

Pourcentage de progression (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

Options disponibles:
text,
image,
audio,
video
Exemple:

"image"

​
usage
object

Informations d'utilisation et de facturation