> ## 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. # Qwen Bild 3.0 > - Qwen (qwen-image-3.0) ist die **Standard-Edition** von Qwen Bildgenerierung und -bearbeitung 3.0 und unterstützt ebenfalls beide Modi: Text-zu-Bild (T2I, ohne Referenzbild) und Bildbearbeitung (I2I, mit 1-3 Referenzbildern) – ausgewogen zwischen Qualität und Geschwindigkeit - Anfrageparameter, Größenlogik und Antwortstruktur sind **identisch** mit [qwen-image-3.0-pro](/de/api-manual/image-series/qwen/qwen-image-3.0-pro); Unterschiede bestehen nur bei Generierungsqualität und Preis - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur [Abfrage](/de/api-manual/task-management/get-task-detail) - Generierte Bildlinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend **Abrechnung:** - Abgerechnet nach „Anzahl der Ausgabebilder × Auflösungsstufe“; in der Standard-Edition **kosten `1K` und `2K` gleich viel** (anders als bei Pro, wo 2K teurer ist) - Bei übergebenen Referenzbildern (I2I) wird **jedes Referenzbild zusätzlich einmal berechnet**; diese Gebühr ist unabhängig von `n` und skaliert nicht mit der Anzahl der Ausgabebilder - Der Einzelpreis liegt unter dem von Pro – bei Kostenoptimierung bevorzugt dieses Modell wählen ## OpenAPI ````yaml de/api-manual/image-series/qwen/qwen-image-3.0.json POST /v1/images/generations openapi: 3.1.0 info: title: qwen-image-3.0 Schnittstelle description: >- Qwen Bild 3.0 Standard-Edition für Bildgenerierung und -bearbeitung mit vereinfachter Modellparameterkonfiguration verwenden license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] tags: - name: Bildgenerierung description: APIs zur KI-Bildgenerierung paths: /v1/images/generations: post: tags: - Bildgenerierung summary: qwen-image-3.0 Schnittstelle description: >- - Qwen (qwen-image-3.0) ist die **Standard-Edition** von Qwen Bildgenerierung und -bearbeitung 3.0 und unterstützt ebenfalls beide Modi: Text-zu-Bild (T2I, ohne Referenzbild) und Bildbearbeitung (I2I, mit 1-3 Referenzbildern) – ausgewogen zwischen Qualität und Geschwindigkeit - Anfrageparameter, Größenlogik und Antwortstruktur sind **identisch** mit [qwen-image-3.0-pro](/de/api-manual/image-series/qwen/qwen-image-3.0-pro); Unterschiede bestehen nur bei Generierungsqualität und Preis - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur [Abfrage](/de/api-manual/task-management/get-task-detail) - Generierte Bildlinks sind 24 Stunden gültig, bitte speichern Sie diese umgehend **Abrechnung:** - Abgerechnet nach „Anzahl der Ausgabebilder × Auflösungsstufe“; in der Standard-Edition **kosten `1K` und `2K` gleich viel** (anders als bei Pro, wo 2K teurer ist) - Bei übergebenen Referenzbildern (I2I) wird **jedes Referenzbild zusätzlich einmal berechnet**; diese Gebühr ist unabhängig von `n` und skaliert nicht mit der Anzahl der Ausgabebilder - Der Einzelpreis liegt unter dem von Pro – bei Kostenoptimierung bevorzugt dieses Modell wählen operationId: createQwenImage30Generation requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/QwenImageEditRequest' examples: text_to_image: summary: Text-zu-Bild (T2I, ohne Referenzbild) value: model: qwen-image-3.0 prompt: >- An orange cat wearing an astronaut helmet, cyberpunk neon background size: '16:9' quality: 2K image_edit: summary: Bildbearbeitung (I2I, mit 1-3 Referenzbildern) value: model: qwen-image-3.0 prompt: Replace the background of this image image_urls: - https://example.com/image1.png 'n': 2 size: '1:1' quality: 2K responses: '200': description: Bildaufgabe 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 autorisiert, 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 Kontingent, Aufladung erforderlich 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: qwen-image-3.0' 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: QwenImageEditRequest: type: object required: - model - prompt properties: model: type: string description: Modellname enum: - qwen-image-3.0 default: qwen-image-3.0 example: qwen-image-3.0 prompt: type: string description: >- Prompt, der das zu generierende Bild beschreibt (Text-zu-Bild) oder wie das Eingabebild bearbeitet werden soll (Bildbearbeitung). Begrenzt auf 4500 Token example: Replace the background of this image maxLength: 4500 image_urls: type: array description: >- Referenzbild-URL-Liste (**optional**). Nicht angegeben oder leeres Array = Text-zu-Bild (T2I); 1-3 Bilder = Bildbearbeitung (I2I) **Hinweis:** - Unterstützte Anzahl von Eingabebildern pro Anfrage: `0-3` Bilder, mehr als 3 Bilder führen zu einem Fehler - Nur öffentliche http/https-Bild-URLs werden unterstützt, base64 / data-url wird nicht unterstützt - Bildbreite und -höhe müssen im Bereich von `[384-3072]` Pixeln liegen - Unterstützte Dateiformate: `.jpg`, `.jpeg`, `.png`, `.bmp`, `.webp`, `.tiff` - Bild-URLs müssen direkt vom Server abrufbar sein oder die Bild-URL sollte beim Zugriff direkt heruntergeladen werden (typischerweise enden diese URLs mit Bilddateiendungen wie `.png`, `.jpg`) items: type: string format: uri example: - https://example.com/image1.png - https://example.com/image2.png 'n': type: integer description: >- Gibt die Anzahl der zu generierenden Bilder an, unterstützt jeden ganzzahligen Wert zwischen `[1,6]` **Hinweis:** - Jede Anfrage wird basierend auf dem Wert von `n` vorbelastet, die tatsächliche Abrechnung basiert auf der Anzahl der generierten Bilder - Die Gebühr für Referenzbilder (`image_urls`) wird **nur einmal je hochgeladenem Bild berechnet** und skaliert nicht mit `n` minimum: 1 maximum: 6 default: 1 example: 1 negative_prompt: type: string description: >- Negativer Prompt zur Beschreibung von Inhalten, die Sie nicht im Bild sehen möchten, wird zur Einschränkung der Ausgabe verwendet **Hinweis:** - Unterstützt Chinesisch und Englisch, maximale Länge von `500` Zeichen, jedes chinesische Zeichen/jeder Buchstabe zählt als ein Zeichen, Überschuss wird automatisch abgeschnitten maxLength: 500 example: >- low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions size: type: string description: >- Die Größe des generierten Bildes, unterstützt drei Optionen: **Option 1 – Automatisch (Standard):** - `auto`: Das Modell wählt anhand des Prompts automatisch eine passende Ausgabegröße (in diesem Fall hat `quality` keine Wirkung) **Option 2 – Seitenverhältnis-Format:** - `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `9:21` - Wird zusammen mit dem Parameter `quality` verwendet; das System rechnet automatisch in die Pixel des entsprechenden Seitenverhältnisses und der entsprechenden Auflösung um, ohne dass eine manuelle Angabe erforderlich ist **Option 3 – Pixelformat:** - Breite×Höhe, z. B.: `1024x1024`, `2048x2048`, `2720x1530` usw. - Wertebereich der Gesamtpixel: `[262144, 4194304]` (d. h. 512×512 bis 2048×2048) - Wertebereich des Seitenverhältnisses: `[1/16, 16]`, eine Seite darf 2048px überschreiten - Breite und Höhe müssen jeweils größer sein als `14px` **Hinweis:** - `size` und `n` sind voneinander unabhängig; auch bei `n>1` können Größe/Seitenverhältnis angegeben werden - Wird `size` nicht angegeben, gilt standardmäßig `auto` default: auto example: '16:9' quality: type: string description: >- Auflösungsstufe, wird zusammen mit dem Seitenverhältnis-Format von `size` verwendet, Standard `1K` (bei `auto` und im Pixelformat ohne Wirkung). | Seitenverhältnis | 1K | 2K | |---|---|---| | `1:1` | 1024×1024 | 2048×2048 | | `2:3` | 832×1248 | 1664×2496 | | `3:2` | 1248×832 | 2496×1664 | | `3:4` | 864×1152 | 1770×2360 | | `4:3` | 1152×864 | 2360×1770 | | `4:5` | 896×1120 | 1792×2240 | | `5:4` | 1120×896 | 2240×1792 | | `9:16` | 800×1424 | 1530×2720 | | `16:9` | 1424×800 | 2720×1530 | | `21:9` | 1568×672 | 3122×1338 | | `9:21` | 672×1568 | 1338×3122 | enum: - 1K - 2K default: 1K example: 2K prompt_extend: type: boolean description: >- Ob die intelligente Prompt-Umschreibung aktiviert werden soll. Standardwert ist `false` (der Prompt des Nutzers wird nicht eigenmächtig umgeschrieben); nur bei explizitem `true` wird ein großes Modell zur Optimierung des positiven Prompts verwendet, was bei unzureichend beschreibenden, einfacheren Prompts deutliche Verbesserungen bringt default: false example: true watermark: type: boolean description: >- Ob ein "Qwen-Image"-Wasserzeichen in der unteren rechten Ecke des Bildes hinzugefügt werden soll. Standardwert ist `false` default: false example: false seed: type: integer description: >- Zufalls-Seed, Bereich `[0, 2147483647]`, die Verwendung desselben Seed-Werts kann den generierten Inhalt relativ stabil halten **Hinweis:** - Wenn nicht angegeben, verwendet der Algorithmus automatisch einen zufälligen Seed - Der Modellgenerierungsprozess ist probabilistisch, selbst mit demselben Seed können die Ergebnisse nicht garantiert jedes Mal vollständig identisch sein minimum: 0 maximum: 2147483647 example: 12345 callback_url: type: string description: >- HTTPS-Callback-Adresse nach Aufgabenabschluss **Callback-Zeitpunkt:** - Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde - Wird nach Abschluss der Abrechnungsbestätigung gesendet **Sicherheitsbeschränkungen:** - Nur HTTPS-Protokoll wird unterstützt - Callback an interne IP-Adressen ist 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 - Maximal `3` Wiederholungsversuche bei Fehler (Wiederholung nach `1` Sekunde/`2` Sekunden/`4` Sekunden) - Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API - Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1757156493 id: type: string description: Aufgaben-ID example: task-unified-1757156493-imcg5zqt model: type: string description: Tatsächlich verwendeter Modellname example: qwen-image-3.0 object: type: string enum: - image.generation.task description: Spezifischer Aufgabentyp 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 Aufgabeninformationen type: type: string enum: - text - image - audio - video description: Aufgaben-Ausgabetyp 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 Abschlusszeit (Sekunden) minimum: 0 example: 30 Usage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel enum: - per_call - per_image - per_token - per_second example: per_image credits_reserved: type: number description: Geschätzter Guthabenverbrauch minimum: 0 example: 2.2483 user_group: type: string description: Benutzergruppenkategorie example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle APIs erfordern Bearer-Token-Authentifizierung## **API-Schlüssel erhalten:** Besuchen Sie die [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API-Schlüssel zu erhalten **Zum Anfrage-Header hinzufügen:** ``` Authorization: Bearer YOUR_API_KEY ``` ````