> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/fr/api-manual/image-series/midjourney/midjourney-v8-2-prompt-guide)
- 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](/fr/api-manual/task-management/get-task-detail)
- 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

<Note>
  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.
</Note>


## OpenAPI

````yaml fr/api-manual/image-series/midjourney/mj-v8-2-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Interface de génération d'images Midjourney V8.2
  description: Créer des tâches de génération d'images avec le modèle Midjourney V8.2
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/images/generations:
    post:
      tags:
        - Génération d'images
      summary: Interface de génération d'images Midjourney V8.2
      description: >-
        - 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](/fr/api-manual/image-series/midjourney/midjourney-v8-2-prompt-guide)

        - 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](/fr/api-manual/task-management/get-task-detail)

        - 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
      operationId: createMjV82ImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Texte vers image
                value:
                  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
              text_to_image_hd:
                summary: Texte vers image (Fast + HD)
                value:
                  model: mj-v8.2
                  prompt: >-
                    A cinematic shot of a Maine Coon cat on a neon-lit balcony
                    --ar 16:9 --s 500
                  quality: hd
                  model_params:
                    speed: fast
              text_to_image_hd_quality:
                summary: Texte vers image (HD + --q 3)
                value:
                  model: mj-v8.2
                  prompt: >-
                    A cinematic shot of a Maine Coon cat on a neon-lit balcony
                    --ar 16:9 --s 500 --q 3
                  quality: hd
                  model_params:
                    speed: fast
              image_to_image:
                summary: Image vers image
                value:
                  model: mj-v8.2
                  prompt: >-
                    https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg
                    A sunset landscape in watercolor style --iw 1.5 --ar 16:9
                  quality: standard
                  model_params:
                    speed: fast
      responses:
        '200':
          description: Tâche créée avec succès
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageGenerationResponse'
        '400':
          description: Paramètres de requête invalides
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Non authentifié, token invalide ou expiré
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Quota insuffisant, veuillez recharger
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: insufficient_quota
                  message: Insufficient quota. Please top up your account.
                  type: insufficient_quota
        '403':
          description: Accès refusé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: 'Token does not have access to model: mj-v8.2'
                  type: invalid_request_error
        '429':
          description: Limite de débit dépassée
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Too many requests, please try again later
                  type: rate_limit_error
        '500':
          description: Erreur interne du serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Internal server error
                  type: api_error
components:
  schemas:
    ImageGenerationRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          enum:
            - mj-v8.2
          default: mj-v8.2
          description: Nom du modèle
        prompt:
          type: string
          description: >-
            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.
          maxLength: 2048
          example: >-
            A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9
            --s 500
        quality:
          type: string
          enum:
            - standard
            - hd
          default: standard
          description: >-
            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`.
        model_params:
          type: object
          description: Paramètres du modèle
          properties:
            speed:
              type: string
              enum:
                - draft
                - fast
              default: fast
              description: >-
                Mode de vitesse


                - `draft` : mode esquisse. Renvoie 24 images d'esquisse légères
                en 0.5K en une seule exécution (au lieu de 4), idéal pour
                explorer rapidement des idées de composition. Mutuellement
                exclusif avec `quality: hd`

                - `fast` : mode standard (par défaut)
        callback_url:
          type: string
          description: >-
            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
            `1`s/`2`s/`4`s 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
          format: uri
          example: https://your-domain.com/webhooks/image-task-completed
    ImageGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Horodatage de création de la tâche
          example: 1757165031
        id:
          type: string
          description: ID de la tâche
          example: task-unified-1757165031-mjv82
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: mj-v8.2
        object:
          type: string
          enum:
            - image.generation.task
          description: Type d'objet de la tâche
        progress:
          type: integer
          description: Pourcentage de progression de la tâche (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Statut de la tâche
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/TaskInfo'
          description: Informations de tâche asynchrone
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Type de sortie de la tâche
          example: image
        usage:
          $ref: '#/components/schemas/Usage'
          description: Informations d'utilisation et de facturation
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Identifiant du code d'erreur
            message:
              type: string
              description: Message d'erreur
            type:
              type: string
              description: Type d'erreur
    TaskInfo:
      type: object
      properties:
        estimated_time:
          type: integer
          description: Temps d'achèvement estimé (secondes)
          minimum: 0
          example: 45
    Usage:
      type: object
      description: Informations d'utilisation et de facturation
      properties:
        billing_rule:
          type: string
          description: Règle de facturation
          enum:
            - per_call
            - per_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Crédits estimés consommés
          minimum: 0
          example: 1.8
        user_group:
          type: string
          description: Groupe d'utilisateurs
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ## Toutes les interfaces nécessitent une authentification par Bearer
        Token ##


        **Obtenir une clé API :**


        Visitez la [page de gestion des clés
        API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API


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

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.