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

> - Das Midjourney V8.1 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 0,5K-Skizzenbilder in einem einzigen Durchlauf
- Unterstützt Text-zu-Bild und Bild-zu-Bild (Bild-URLs im Prompt referenzieren)
- V8.1-Highlights: native HD-Ausgabe (`quality=hd`), etwa 5x schnellere Generierung als die Vorgängergeneration, verbesserte Textwiedergabe (in Anführungszeichen gesetzter Text wird genauer wiedergegeben) und stärkere Prompt-Treue
- Kompatibel mit V7-Assets: Stilreferenz (`--sref`) und Objektreferenz (`--oref`) werden unterstützt, siehe [Prompt-Parameter-Handbuch](/de/api-manual/image-series/midjourney/midjourney-v8-1-prompt-guide)
- 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.1 und unterstützt kein niji; legen Sie den Geschwindigkeitsmodus über `model_params.speed` und die Ausgabequalität über den Top-Level-Parameter `quality` fest

<Note>
  Midjourney verfügt über ein integriertes Moderationssystem. Wenn einige generierte Bilder durch die Moderation gefiltert werden, können die für diese Anfrage verbrauchten Credits nicht erstattet werden. Bitte achten Sie darauf, dass Ihre Prompts den Inhaltsrichtlinien entsprechen.
</Note>


## OpenAPI

````yaml de/api-manual/image-series/midjourney/mj-v8-1-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Midjourney V8.1 Bildgenerierung Schnittstelle
  description: Bildgenerierungsaufgaben mit dem Midjourney V8.1 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.1 Bildgenerierung Schnittstelle
      description: >-
        - Das Midjourney V8.1 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
        0,5K-Skizzenbilder in einem einzigen Durchlauf

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

        - V8.1-Highlights: native HD-Ausgabe (`quality=hd`), etwa 5x schnellere
        Generierung als die Vorgängergeneration, verbesserte Textwiedergabe (in
        Anführungszeichen gesetzter Text wird genauer wiedergegeben) und
        stärkere Prompt-Treue

        - Kompatibel mit V7-Assets: Stilreferenz (`--sref`) und Objektreferenz
        (`--oref`) werden unterstützt, siehe
        [Prompt-Parameter-Handbuch](/de/api-manual/image-series/midjourney/midjourney-v8-1-prompt-guide)

        - 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.1 und unterstützt kein
        niji; legen Sie den Geschwindigkeitsmodus über `model_params.speed` und
        die Ausgabequalität über den Top-Level-Parameter `quality` fest
      operationId: createMjV81ImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Text zu Bild
                value:
                  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
              text_to_image_hd:
                summary: Text zu Bild (Fast + HD)
                value:
                  model: mj-v8.1
                  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
              image_to_image:
                summary: Bild zu Bild
                value:
                  model: mj-v8.1
                  prompt: >-
                    https://example.com/ref.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.1'
                  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.1
          default: mj-v8.1
          description: Modellname
        prompt:
          type: string
          description: >-
            Prompt, unterstützt die gesamte native Parametersyntax von
            Midjourney V8.1 (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
          maxLength: 1024
          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)


                **Preishinweis:** `draft` und `fast` teilen sich denselben
                Geschwindigkeitsmultiplikator (1x). Dieser
                Geschwindigkeitsmultiplikator wird dann mit dem
                `quality`-Multiplikator kombiniert (multipliziert).
        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-mjv81
        model:
          type: string
          description: Tatsächlich verwendeter Modellname
          example: mj-v8.1
        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:
        can_cancel:
          type: boolean
          description: Ob die Aufgabe abgebrochen werden kann
          example: true
        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

        ```

````