API-Referenz

Qwen-API-Dokumentation

Kompakte Referenz für Authentifizierung, Qwen-Bildgenerierung, asynchrone Tasks, Modell-IDs und Fehler.

API-Schlüssel erstellen Modelle

Schnellstart

Die API nutzt Standard-JSON über HTTPS. Schlüssel erstellen, Generierung senden und Task-ID abfragen.

01
Bearer-Schlüssel erstellen
02
Generierung senden
03
Task-ID abfragen

Basis-URL

Alle öffentlichen API-Anfragen verwenden die Domain qwenapi.org.

https://qwenapi.org

Authentifizierung

Senden Sie den Qwen-API-Schlüssel bei Generierung, Status und Verlauf im Authorization-Header.

Authorization: Bearer $QWEN_API_KEY

Bewahren Sie API-Schlüssel auf Ihrem Server auf. Nicht in Browser-Bundles, öffentlichen Repositories oder Client-Logs veröffentlichen.

Bild generieren

Senden Sie eine unterstützte Live-Modell-ID und die modellspezifischen Eingabefelder.

POST/api/v1/images/generations

curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3",
    "prompt": "Editorial product photo in soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

Annahmeantwort

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n86...qw3",
    "status": "IN_PROGRESS"
  }
}

Task-Status abrufen

Nutzen Sie die Task-ID für Fortschritt, Fehler und finale Ausgabe-URLs.

GET/api/v1/tasks/:task_id

curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $QWEN_API_KEY"

IN_PROGRESS

Das Backend hat den Task angenommen und arbeitet.

SUCCESS

Ausgabe-URLs stehen zum Abruf bereit.

FAILED

Der Task wurde mit einem strukturierten Fehler beendet.

Live-Modell-IDs

Nur diese IDs werden derzeit an produktive Routen mit Abrechnung weitergeleitet.

Modell	Kosten	Eingabe	Ausgabe
qwen-image-3	10 credits / image	Text, up to 3 images	PNG or JPEG
qwen2-image	10 credits / image	Text or image	PNG or JPEG
qwen-image-2512	5 credits / image	Text or images	PNG, JPEG, WebP
qwen-multi-angles	5 credits / image	1-3 images	PNG or JPEG
qwen-layered	10 credits / layer	Image and instruction	Layer images

Fehler

HTTP-Statuscodes enthalten strukturierte JSON-Fehler. Bewahren Sie Task-ID und Nachricht für den Support auf.

400invalid_requestModell-ID und Anfragefelder prüfen.

401unauthorizedPrüfen, ob der Bearer-Schlüssel vorhanden und aktiv ist.

402insufficient_creditsCredits im Abrechnungs-Dashboard hinzufügen.

404not_foundPrüfen, ob die Task-ID zu einer Qwen-Route gehört.

429rate_limitedMit Backoff und Jitter erneut versuchen.

500server_errorSpäter wiederholen und Task-ID für den Support behalten.