Qwen Image 3.0 Pro API

Vollständige API-Referenz für die von Alibaba Qwen bereitgestellten Qwen Image 3.0 Standard- und Pro-Modelle.

Modellvarianten

Diese API unterstützt vier Modellvarianten:

Schnellvergleich

Unterstützte Seitenverhältnisse

Alle vier Modelle unterstützen diese Seitenverhältnisse:

16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Endpunkt

POST /api/v1/image/task

Authentifizierung

Authorization: Bearer YOUR_API_KEY

Text-zu-Bild-Generierung

Verwenden Sie qwen-image-3.0 für das Standardmodell oder qwen-image-3.0-pro für das Pro-Modell.

Anfrageparameter

Erforderlich

Das Verhältnis von Breite zu Höhe muss einem dieser Werte entsprechen: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

Fakultativ

Beispielanfrage für Standard

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'qwen-image-3.0',
    prompt: 'A professional product photo with soft studio lighting',
    width: 16,
    height: 9,
    resolution: '1k',
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Beispielanfrage für Pro

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'qwen-image-3.0-pro',
    prompt: 'A detailed editorial product scene with precise typography and cinematic lighting',
    width: 16,
    height: 9,
    resolution: '2k',
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Bildbearbeitung

Verwenden Sie qwen-image-3.0-edit für das Standard-Edit-Modell oder qwen-image-3.0-pro-edit für das Pro-Edit-Modell.

Anfrageparameter

Erforderlich

Das Verhältnis von Breite zu Höhe muss einem dieser Werte entsprechen: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

Fakultativ

Beispielanfrage für Standard Edit

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'qwen-image-3.0-edit',
    prompt: 'Transform the input into a polished editorial portrait with soft studio lighting',
    width: 16,
    height: 9,
    resolution: '1k',
    image_url_list: ['https://example.com/image1.jpg'],
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Pro-Edit-Beispielanfrage mit mehreren Bildern

javascriptKopieren
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'qwen-image-3.0-pro-edit',
    prompt: 'Combine the products from these references into one cohesive campaign image',
    width: 16,
    height: 9,
    resolution: '2k',
    image_url_list: [
      'https://example.com/image1.jpg',
      'https://example.com/image2.jpg',
      'https://example.com/image3.jpg'
    ],
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id zum Abrufen des Status zurück:

jsonKopieren
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "submitted",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}"
  },
  "message": "success"
}

Polling-Antwort

Rufen Sie GET /api/v1/image/{task_id} ab, um den Aufgabenstatus zu prüfen:

jsonKopieren
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 0.0997,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  },
  "message": "success"
}

Statuswerte

• submitted: Aufgabe angenommen
• processing: Generierung läuft
• succeed: Generierung erfolgreich abgeschlossen
• failed: Generierung fehlgeschlagen

Bewährte Vorgehensweisen

Tipps zur Text-zu-Bild-Generierung

1. Seien Sie konkret: Geben Sie Motiv, Stil, Beleuchtung, Komposition und Textanforderungen im Prompt an.
2. Wählen Sie die Auflösung: Wählen Sie je nach erforderlicher Ausgabeauflösung 1k oder 2k.
3. Wählen Sie das Seitenverhältnis: Stimmen Sie das Verhältnis auf das Zielmedium ab, etwa 16:9 für Banner oder 9:16 für vertikale Inhalte.
4. Nutzen Sie den Seed für Reproduzierbarkeit: Legen Sie einen festen seed fest, wenn Sie wiederholbare Generierungseinstellungen benötigen.

Tipps zur Bildbearbeitung

1. Verwenden Sie klare Anweisungen: Beschreiben Sie, was geändert und was beibehalten werden soll.
2. Ordnen Sie mehrere Eingaben bewusst an: Stellen Sie 1–3 Bilder bereit und erklären Sie die Rolle jeder Referenz im Prompt.
3. Wählen Sie die Ausgabeauflösung: Wählen Sie 1k oder 2k unabhängig von den Abmessungen der Eingabebilder.
4. Verwenden Sie hochwertige Eingaben: Klare Quellbilder liefern im Allgemeinen besser kontrollierbare Bearbeitungsergebnisse.