> ## 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 Bildgenerierung

> - Das Midjourney V8.2 Modell unterstützt die Generierung hochwertiger Bilder per natürlichsprachigem Prompt. Der Fast-Modus liefert 4 Bilder pro Generierung; der Draft-Modus liefert 24 leichtgewichtige 512-px-Skizzenbilder in einem einzigen Durchlauf
- Unterstützt Text-zu-Bild und Bild-zu-Bild (Bild-URLs im Prompt referenzieren)
- Eingabebild-URLs müssen öffentlich erreichbar und innerhalb von etwa 10 Sekunden abrufbar sein; der Upstream lädt Bilder beim Erstellen der Aufgabe synchron und gibt 400 zurück, wenn dies nicht gelingt. Bild-Hoster außerhalb Festlandchinas (imgur, ibb, raw.githubusercontent, pinimg, picsum) schlagen in der Praxis fehl. Hosten Sie Bilder auf einem schnellen CDN oder nutzen Sie den Datei-Upload der Plattform
- V8.2-Highlights: Ästhetik- und Bildqualitäts-Upgrade gegenüber V8.1, eine Detailstufe, die über das native Parameter `--quality` / `--q` (1–4, 4 = Hochqualitätsmodus) im Prompt gesetzt wird (ohne Aufpreis), und native 2K-Ausgabe (`quality=hd`). Turbo ist auf V8.2 nicht verfügbar (der Upstream dokumentiert V8 als ohne Turbo-Unterstützung)
- Stilreferenz (`--sref`) wird unterstützt; `--oref` / `--cref` werden auf V8.2 **nicht** unterstützt und vom Upstream abgelehnt, siehe [Prompt-Parameter-Handbuch](/de/api-manual/image-series/midjourney/midjourney-v8-2-prompt-guide)
- Vom Upstream nicht unterstützte Prompt-Parameters werden unverändert durchgereicht: Die Aufgabe schlägt mit einem Parameterfehler (`invalid_parameters`) fehl und reservierte Credits werden erstattet (sie werden nicht mehr stillschweigend verworfen)
- Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Abfragen des Status](/de/api-manual/task-management/get-task-detail)
- Generierte Bildlinks sind 30 Tage gültig, bitte zeitnah speichern
- Timeout: ca. 20 Minuten
- Parameterhinweis: Diese Route läuft auf V8.2 und unterstützt kein niji; legen Sie den Geschwindigkeitsmodus über `model_params.speed` und die Ausgabequalität über den Top-Level-Parameter `quality` fest; die Detailstufe wird als `--quality` / `--q` (1–4) in den Prompt geschrieben und unverändert durchgereicht
- `mj-v8.2-edit` / `mj-v8.2-upload-paint` sind Canvas-Bearbeitungen (img_pos + Maske). Der anweisungsbasierte Bearbeitungs-Endpunkt des Upstreams (`--edit`, bis zu 4 Referenzbilder) ist auf dieser Route noch nicht verfügbar und wird derzeit eingeplant

<Note>
  Midjourney verfügt über ein integriertes Moderationssystem. Jedes Bild wird einzeln geprüft: Gefilterte Bilder erscheinen nicht in den Ergebnissen, die übrigen Bilder werden normal geliefert, sodass Sie weniger Bilder als üblich erhalten können. Besteht mindestens ein Bild die Prüfung, ist die Aufgabe `completed` und wird normal abgerechnet; werden alle Bilder gefiltert, endet die Aufgabe als `failed` und die reservierten Credits werden vollständig erstattet. Bitte achten Sie darauf, dass Ihre Prompts und Referenzbilder den Inhaltsrichtlinien entsprechen.
</Note>


## OpenAPI

````yaml de/api-manual/image-series/midjourney/mj-v8-2-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Midjourney V8.2 Bildgenerierung Schnittstelle
  description: Bildgenerierungsaufgaben mit dem Midjourney V8.2 Modell erstellen
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Produktionsumgebung
security:
  - bearerAuth: []
paths:
  /v1/images/generations:
    post:
      tags:
        - Bildgenerierung
      summary: Midjourney V8.2 Bildgenerierung Schnittstelle
      description: >-
        - Das Midjourney V8.2 Modell unterstützt die Generierung hochwertiger
        Bilder per natürlichsprachigem Prompt. Der Fast-Modus liefert 4 Bilder
        pro Generierung; der Draft-Modus liefert 24 leichtgewichtige
        512-px-Skizzenbilder in einem einzigen Durchlauf

        - Unterstützt Text-zu-Bild und Bild-zu-Bild (Bild-URLs im Prompt
        referenzieren)

        - Eingabebild-URLs müssen öffentlich erreichbar und innerhalb von etwa
        10 Sekunden abrufbar sein; der Upstream lädt Bilder beim Erstellen der
        Aufgabe synchron und gibt 400 zurück, wenn dies nicht gelingt.
        Bild-Hoster außerhalb Festlandchinas (imgur, ibb, raw.githubusercontent,
        pinimg, picsum) schlagen in der Praxis fehl. Hosten Sie Bilder auf einem
        schnellen CDN oder nutzen Sie den Datei-Upload der Plattform

        - V8.2-Highlights: Ästhetik- und Bildqualitäts-Upgrade gegenüber V8.1,
        eine Detailstufe, die über das native Parameter `--quality` / `--q`
        (1–4, 4 = Hochqualitätsmodus) im Prompt gesetzt wird (ohne Aufpreis),
        und native 2K-Ausgabe (`quality=hd`). Turbo ist auf V8.2 nicht verfügbar
        (der Upstream dokumentiert V8 als ohne Turbo-Unterstützung)

        - Stilreferenz (`--sref`) wird unterstützt; `--oref` / `--cref` werden
        auf V8.2 **nicht** unterstützt und vom Upstream abgelehnt, siehe
        [Prompt-Parameter-Handbuch](/de/api-manual/image-series/midjourney/midjourney-v8-2-prompt-guide)

        - Vom Upstream nicht unterstützte Prompt-Parameters werden unverändert
        durchgereicht: Die Aufgabe schlägt mit einem Parameterfehler
        (`invalid_parameters`) fehl und reservierte Credits werden erstattet
        (sie werden nicht mehr stillschweigend verworfen)

        - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene
        Aufgaben-ID zum [Abfragen des
        Status](/de/api-manual/task-management/get-task-detail)

        - Generierte Bildlinks sind 30 Tage gültig, bitte zeitnah speichern

        - Timeout: ca. 20 Minuten

        - Parameterhinweis: Diese Route läuft auf V8.2 und unterstützt kein
        niji; legen Sie den Geschwindigkeitsmodus über `model_params.speed` und
        die Ausgabequalität über den Top-Level-Parameter `quality` fest; die
        Detailstufe wird als `--quality` / `--q` (1–4) in den Prompt geschrieben
        und unverändert durchgereicht

        - `mj-v8.2-edit` / `mj-v8.2-upload-paint` sind Canvas-Bearbeitungen
        (img_pos + Maske). Der anweisungsbasierte Bearbeitungs-Endpunkt des
        Upstreams (`--edit`, bis zu 4 Referenzbilder) ist auf dieser Route noch
        nicht verfügbar und wird derzeit eingeplant
      operationId: createMjV82ImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Text zu Bild
                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: Text zu Bild (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: Text zu Bild (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: Bild zu Bild
                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: Aufgabe erfolgreich erstellt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageGenerationResponse'
        '400':
          description: Ungültige Anfrageparameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Nicht authentifiziert, ungültiges oder abgelaufenes Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Unzureichendes Guthaben, bitte aufladen
          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: Zugriff verweigert
          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: Ratenlimit überschritten
          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: Interner Serverfehler
          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: Modellname
        prompt:
          type: string
          description: >-
            Prompt, unterstützt die gesamte native Parametersyntax von
            Midjourney V8.2 (z.B. --ar 16:9 --s 500).


            **Bild-zu-Bild:** Platzieren Sie Bild-URLs am Anfang des Prompts.
            Unterstützte Formate: .png, .gif, .webp, .jpg, .jpeg


            **Bild-zu-Bild-Regeln:**

            - 1 Bild + kein Text = **ungültig** (gibt Fehler zurück)

            - 1 Bild + Textbeschreibung = gültig

            - 2+ Bilder + kein Text = gültig

            - 2+ Bilder + Textbeschreibung = gültig


            **Nicht unterstützte Parameter:** Parameter, die der Upstream nicht
            unterstützt (z. B. `--oref`, `--cref`, `--stop`, `--bs`), werden
            durchgereicht und vom Upstream ausdrücklich abgelehnt: Die Aufgabe
            schlägt mit einem Parameterfehler (`invalid_parameters`) fehl und
            reservierte Credits werden erstattet. `--v` / `--version` / `--niji`
            sowie die Geschwindigkeits-/hd-Parameter werden entfernt und über
            API-Parameter gesteuert; `--quality` / `--q` (1–4) wird
            durchgereicht.
          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: >-
            Ausgabequalität


            - `standard`: Standardauflösung (Standard), 1x Multiplikator

            - `hd`: Native HD-Ausgabe, 1,5x Multiplikator. Schließt sich mit
            `speed: draft` gegenseitig aus


            **Preishinweis:** Der Qualitätsmultiplikator wird mit dem
            `speed`-Multiplikator kombiniert (multipliziert).
        model_params:
          type: object
          description: Modellparameter
          properties:
            speed:
              type: string
              enum:
                - draft
                - fast
              default: fast
              description: >-
                Geschwindigkeitsmodus


                - `draft`: Skizzenmodus. Liefert 24 leichtgewichtige
                0,5K-Skizzenbilder in einem einzigen Durchlauf (statt 4), ideal
                zum schnellen Erkunden von Kompositionsideen. Schließt sich mit
                `quality: hd` gegenseitig aus

                - `fast`: Standardmodus (Standard)
        callback_url:
          type: string
          description: >-
            HTTPS-Callback-URL für Aufgabenabschluss


            **Callback-Zeitpunkt:**

            - Ausgelöst bei Abschluss, Fehler oder Abbruch der Aufgabe

            - Nach Abrechnungsbestätigung gesendet


            **Sicherheitsbeschränkungen:**

            - Nur HTTPS-Protokoll

            - Callbacks an private IP-Adressen verboten (127.0.0.1, 10.x.x.x,
            172.16-31.x.x, 192.168.x.x usw.)

            - URL-Länge darf `2048` Zeichen nicht überschreiten


            **Callback-Mechanismus:**

            - Timeout: `10` Sekunden

            - Bis zu `3` Wiederholungen nach Fehler (Wiederholungen nach
            `1`s/`2`s/`4`s nach Fehler)

            - Das Format des Callback-Antwortkörpers entspricht dem
            Aufgabenabfrage-Endpunkt

            - Ein 2xx-Statuscode gilt als erfolgreich; andere Statuscodes lösen
            Wiederholungen aus
          format: uri
          example: https://your-domain.com/webhooks/image-task-completed
    ImageGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Zeitstempel der Aufgabenerstellung
          example: 1757165031
        id:
          type: string
          description: Aufgaben-ID
          example: task-unified-1757165031-mjv82
        model:
          type: string
          description: Tatsächlich verwendeter Modellname
          example: mj-v8.2
        object:
          type: string
          enum:
            - image.generation.task
          description: Aufgabenobjekttyp
        progress:
          type: integer
          description: Aufgabenfortschritt in Prozent (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Aufgabenstatus
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/TaskInfo'
          description: Asynchrone Aufgabeninformation
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Aufgabenausgabetyp
          example: image
        usage:
          $ref: '#/components/schemas/Usage'
          description: Nutzungs- und Abrechnungsinformationen
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Fehlercode-Bezeichner
            message:
              type: string
              description: Fehlerbeschreibung
            type:
              type: string
              description: Fehlertyp
    TaskInfo:
      type: object
      properties:
        estimated_time:
          type: integer
          description: Geschätzte Fertigstellungszeit (Sekunden)
          minimum: 0
          example: 45
    Usage:
      type: object
      description: Nutzungs- und Abrechnungsinformationen
      properties:
        billing_rule:
          type: string
          description: Abrechnungsregel
          enum:
            - per_call
            - per_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Geschätzte verbrauchte Credits
          minimum: 0
          example: 1.8
        user_group:
          type: string
          description: Benutzergruppe
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ## Alle Endpunkte erfordern Bearer Token Authentifizierung ##


        **API Key erhalten:**


        Besuchen Sie die [API Key
        Verwaltungsseite](https://evolink.ai/dashboard/keys) um Ihren API Key zu
        erhalten


        **Zum Request-Header hinzufügen:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

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