Passer au contenu principal
POST
/
v1
/
images
/
generations
Interface mj-v8.1-edit
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-edit",
  "prompt": "Beautiful mountain scenery background",
  "model_params": {
    "task_id": "task-unified-xxx",
    "image_number": 0,
    "canvas": {
      "width": 1024,
      "height": 1024
    },
    "img_pos": {
      "width": 512,
      "height": 512,
      "x": 256,
      "y": 256
    },
    "speed": "fast"
  }
}
'
{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv81",
  "model": "<string>",
  "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-edit
requis

Nom du modèle

Options disponibles:
mj-v8.1-edit
Exemple:

"mj-v8.1-edit"

​
prompt
string
requis

Décrit le contenu de remplissage souhaité

Exemple:

"Beautiful mountain scenery background"

​
model_params
object
requis

Paramètres d'édition de canevas

​
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 de génération d'images 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é

​
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
​
type
enum<string>
Options disponibles:
text,
image,
audio,
video
Exemple:

"image"

​
usage
object