Entwickler-Ressourcen

Qwen-Image-2512 API Dokumentation

Integrieren Sie das Alibaba Qwen-Image-2512 AI Modell in Ihre Anwendungen. Generieren Sie hochwertige Bilder aus Textbeschreibungen mit einer einfachen REST-API.

1

Authentifizierung

Die Qwen-Image-2512 API verwendet Bearer-Token-Authentifizierung. Übergeben Sie Ihren API-Schlüssel im Request-Header.

Authentifizierung
Authorization: Bearer sk-your-api-key-here

Halten Sie Ihren API-Schlüssel sicher. Geben Sie ihn nicht im clientseitigen Code weiter.

Preise

TypKostenBeschreibung
Text-zu-Bild5 CreditsBilder aus Text-Prompts mit Qwen-Image-2512 AI generieren.
2

Aufgabe erstellen

POSThttps://qwen-image-2512.org/api/generate
Asynchrone Generierung

Preise

Jede Bildgenerierung kostet 5 Credits.

Starten Sie eine Generierungsaufgabe. Die API gibt sofort eine task_id zurück, mit der Sie den Status abfragen können.

Body-Parameter

ParameterTypErforderlichBeschreibung
promptstringErforderlichDie Textbeschreibung für die Bildgenerierung. Max. 2000 Zeichen.
sizestringOptionalBildgröße. Unterstützt: 1024*1024, 1024*1536, 1536*1024, 768*1024, 1024*768. Standard: 1024*1024
seednumberOptionalZufallsseed für reproduzierbare Ergebnisse. -1 für zufällig. Standard: -1
output_formatstringOptionalAusgabeformat: jpeg, png oder webp. Standard: jpeg
callback_urlstringOptionalWebhook-URL für die Benachrichtigung bei Aufgabenerledigung.

Beispielanfragen

Text-zu-Bild Beispiel (cURL)
curl -X POST https://qwen-image-2512.org/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset",
    "size": "1024*1024",
    "output_format": "png"
  }'
Erfolgreiche Antwort
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS"
  }
}
Fehlerantwort
{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}
3

Status prüfen

GEThttps://qwen-image-2512.org/api/status

Fragen Sie diesen Endpunkt ab, um den Fortschritt Ihrer Aufgabe zu überprüfen. Wir empfehlen eine Abfrage alle 5-10 Sekunden.

Abfrageparameter

ParameterTypBeschreibung
task_idstringDie vom Generierungs-Endpunkt erhaltene Task-ID. Erforderlich

Statuswerte

PENDINGAufgabe in der Warteschlange
IN_PROGRESSIn Bearbeitung
SUCCESSAbgeschlossen
FAILEDFehler aufgetreten
cURL
curl -X GET "https://qwen-image-2512.org/api/status?task_id=n43abc123def456qwenimg" \
  -H "Authorization: Bearer YOUR_API_KEY"
Antwort (In Bearbeitung)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}
Antwort (Abgeschlossen)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "SUCCESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": ["https://cdn.example.com/image.png"]
  }
}
Antwort (Fehlgeschlagen)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Fehlercodes

CodeBeschreibung
200Erfolg
400Bad Request - Ungültige Parameter (fehlender Prompt, ungültige Größe, etc.)
401Unauthorized - Fehlender oder ungültiger API-Schlüssel
404Not Found - Task-ID existiert nicht
500Internal Server Error - Bitte versuchen Sie es erneut oder kontaktieren Sie den Support

Benötigen Sie Hilfe?

Besuchen Sie unseren Support-Kanal oder schreiben Sie uns eine E-Mail.

Support kontaktieren