> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Qwen Image 3.0 Bildgenerierung
> - Asynchroner Verarbeitungsmodus, gibt eine Task-ID für spätere Abfragen zurück
- Unterstützt Text-zu-Bild und Bild-zu-Bild (1-3 Referenzbilder zur Bearbeitung)
- Unterstützt 1K- / 2K-Auflösung, bis zu 6 Bilder pro Anfrage
- Standard- und Pro-Varianten (Pro ist stärker bei dichter Layout- und Textarbeit)
```bash cURL theme={null}
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "qwen-image-3.0",
"prompt": "A cafe poster with the title Autumn Limited, warm tones, refined layout",
"size": "16:9",
"resolution": "1K"
}'
```
```python Python theme={null}
import requests
url = "https://api.apimart.ai/v1/images/generations"
payload = {
"model": "qwen-image-3.0",
"prompt": "A cafe poster with the title Autumn Limited, warm tones, refined layout",
"size": "16:9",
"resolution": "1K",
}
headers = {
"Authorization": "Bearer ",
"Content-Type": "application/json",
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
```
```javascript JavaScript theme={null}
const url = "https://api.apimart.ai/v1/images/generations";
const payload = {
model: "qwen-image-3.0",
prompt: "A cafe poster with the title Autumn Limited, warm tones, refined layout",
size: "16:9",
resolution: "1K",
};
const headers = {
Authorization: "Bearer ",
"Content-Type": "application/json",
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload),
})
.then((response) => response.json())
.then((data) => console.log(data))
.catch((error) => console.error("Error:", error));
```
```json 200 theme={null}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01JGXYZ1234567890ABCDEF"
}
]
}
```
```json 400 theme={null}
{
"error": {
"code": 400,
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}
```
```json 401 theme={null}
{
"error": {
"code": 401,
"message": "Authentication failed, please check your API key",
"type": "authentication_error"
}
}
```
```json 402 theme={null}
{
"error": {
"code": 402,
"message": "Insufficient account balance, please top up and try again",
"type": "payment_required"
}
}
```
```json 429 theme={null}
{
"error": {
"code": 429,
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}
```
## Unterstützte Modelle
| Modell | Beschreibung | Max. Bilder | Auflösung |
| -------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | --------- |
| `qwen-image-3.0` | Klare Anweisungsbefolgung, stabile Textwiedergabe; gutes Preis-Leistungs-Verhältnis für den allgemeinen Einsatz | 6 | 1K / 2K |
| `qwen-image-3.0-pro` | Reichhaltigerer Inhalt; ideal für Zeitungen, Storyboards, Speisekarten, Prüfungen, dichte Layouts | 6 | 1K / 2K |
Bevorzugen Sie `-pro` bei dichtem Text/Layout. Verwenden Sie `qwen-image-3.0` für allgemeine Bilder. Prompt max. ca. **4.5k Tokens**. Modellnamen sind nicht mit der 2.0-Serie austauschbar.
## Authorizations
Alle Endpunkte erfordern eine Bearer-Token-Authentifizierung
Holen Sie Ihren API-Key von der [API-Key-Verwaltungsseite](https://apimart.ai/keys):
```
Authorization: Bearer YOUR_API_KEY
```
## Body
Modellname
* `qwen-image-3.0` - Standard
* `qwen-image-3.0-pro` - Pro (dichter Text / Layout)
Textbeschreibung für die Bildgenerierung, max. ca. **4.5k Tokens**
Array mit Referenzbild-URLs (Bild-zu-Bild / Bearbeitung), **1-3 Bilder**
* Öffentliche `http(s)://`-URL oder `data:image/png;base64,...` (Base64 wird zuerst neu hochgeladen)
* Formate: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
* Pro Datei ≤ 10MB; Breite/Höhe empfohlen 384-2048 px
Auflösungsstufe (beeinflusst die Abrechnungsstufe)
* `1K` (Standard; Kleinbuchstaben akzeptiert)
* `2K`
Sie können die Stufe weglassen und Pixel in `size` angeben (z. B. `1600x900`). Bei Rohpixeln wird eine Fläche **> 2.25M Pixel** als 2K abgerechnet.
Seitenverhältnis oder explizite Pixelgröße
Unterstützte Verhältnisse:
* `1:1` (Standard)
* `4:3` / `3:4`
* `16:9` / `9:16`
* `3:2` / `2:3`
Auch `16x9`-Stil oder Pixel wie `1024x1024`. Bei benutzerdefinierten Pixeln muss **jede Kante** (Breite und Höhe) **512–2048** sein, Seitenverhältnis 1:8 \~ 8:1.
Wenn weder `size` noch `resolution` gesetzt sind, ist die Ausgabe fest **1024×1024**.
Anzahl der Bilder, **1-6**. Werte über 6 werden auf 6 begrenzt.
Negativer Prompt: zu vermeidende Inhalte
Intelligente Prompt-Umschreibung
Standardmäßig **aus**, damit Ergebnisse vorhersagbar bleiben. Zum Aktivieren auf `true` setzen.
Umschreibmodus (nur 3.0-Serie; erfordert `prompt_extend: true`)
* `direct` - funktioniert für Text-zu-Bild und Bild-zu-Bild
* `agent` - **nur Text-zu-Bild**, aggressivere Umschreibung
Ungültige Werte werden ignoriert.
## Größentabelle
Kombiniert `resolution` (Stufe) + `size` (Verhältnis):
| Auflösung | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 |
| --------- | --------- | --------- | --------- | --------- | --------- | --------- | --------- |
| **1K** | 1024×1024 | 1152×864 | 864×1152 | 1280×720 | 720×1280 | 1248×832 | 832×1248 |
| **2K** | 2048×2048 | 2048×1536 | 1536×2048 | 2048×1152 | 1152×2048 | 2048×1360 | 1360×2048 |
## Anwendungsfälle
### Text-zu-Bild (mehrere)
```json theme={null}
{
"model": "qwen-image-3.0",
"prompt": "Flat illustration of a city skyline at dusk, warm orange tones",
"size": "16:9",
"resolution": "1K",
"n": 4
}
```
### Dichtes Layout mit Umschreibung
```json theme={null}
{
"model": "qwen-image-3.0-pro",
"prompt": "A Western restaurant menu with appetizers, mains, and desserts columns, five dishes each with prices, serif font, cream background",
"size": "3:4",
"resolution": "2K",
"prompt_extend": true,
"prompt_extend_mode": "agent"
}
```
### Bild-zu-Bild (Bearbeitung)
```json theme={null}
{
"model": "qwen-image-3.0-pro",
"prompt": "Change the sign text to Open, keep everything else the same",
"image_urls": ["https://example.com/shop.jpg"],
"size": "1:1"
}
```
### Negativer Prompt
```json theme={null}
{
"model": "qwen-image-3.0",
"prompt": "Photorealistic mountain cabin in morning mist",
"negative_prompt": "text, watermark, people, low resolution",
"size": "3:2"
}
```
## Limits
| Element | Limit |
| --------------- | -------------------------------------------------------------------------- |
| Prompt | ≤ 4.5k Tokens |
| Ausgabegröße | Benutzerdefinierte Pixel: jede Kante 512–2048; Seitenverhältnis 1:8 \~ 8:1 |
| Bildanzahl | 1-6 (Überschuss begrenzt) |
| Referenzbilder | 1-3 |
| Referenzformate | JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF |
| Referenzgröße | ≤ 10MB; Breite/Höhe empfohlen 384-2048 px |
## Response
Statuscode; 200 bei Erfolg
Antwortdaten-Array
Task-Status; bei Erstellung `submitted`
Task-ID zum Abfragen der Ergebnisse
## Unterschiede zu 2.0
| | 2.0-Serie | 3.0-Serie |
| -------------------- | ----------------- | ----------------------- |
| Promptlänge | Kürzer | \~4.5k Tokens |
| `prompt_extend_mode` | Nicht unterstützt | `direct` / `agent` |
| Auflösung | 1K / 2K | 1K / 2K (Pro 2K teurer) |
| Referenzbilder | Unterstützt | 1-3 Bilder |
## Hinweise
1. **Asynchron**: Nach dem Absenden erhalten Sie eine `task_id`. Abfragen Sie [Aufgabenstatus abrufen](/de/api-reference/tasks/status) alle **3\~5 Sekunden**; Client-Timeout ca. **3 Minuten** (2K + mehrere Bilder ist langsamer).
2. **Speicherung**: Bilder werden auf das Plattform-CDN gespiegelt und sind langfristig verfügbar.
3. **Abrechnung**: Pro geliefertem Bild × Auflösungsstufe nach **tatsächlicher Pixelfläche** (> 2.25M Pixel = 2K). `qwen-image-3.0` berechnet 1K/2K gleich; `-pro` 2K ist 2× 1K. Bei Fehlern volle Rückerstattung; Referenzbilder sind kostenlos.
4. **Fehler**: Ungültige size/Verhältnisse, `agent` bei Bild-zu-Bild, unerreichbare/zu große Referenzen → 400; Ratenlimit → 429.
**Ergebnisse abfragen**
Verwenden Sie [Aufgabenstatus abrufen](/de/api-reference/tasks/status) für Fortschritt und `result.images`.