API Qwen Image 3.0 Pro

Référence complète de l'API pour les modèles Qwen Image 3.0 Standard et Pro fournis par Alibaba Qwen.

Variantes du modèle

Cette API prend en charge quatre variantes du modèle :

Comparaison rapide

Formats d'image pris en charge

Les quatre modèles prennent en charge les formats d'image suivants :

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

Point de terminaison

POST /api/v1/image/task

Authentification

Authorization: Bearer YOUR_API_KEY

Génération de texte en image

Utilisez qwen-image-3.0 pour le modèle Standard ou qwen-image-3.0-pro pour le modèle Pro.

Paramètres de la requête

Obligatoires

Le rapport largeur-hauteur doit être l'un des suivants : 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

Facultatifs

Exemple de requête Standard

javascriptCopier
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;

Exemple de requête Pro

javascriptCopier
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;

Édition d'images

Utilisez qwen-image-3.0-edit pour le modèle Standard Edit ou qwen-image-3.0-pro-edit pour le modèle Pro Edit.

Paramètres de la requête

Obligatoires

Le rapport largeur-hauteur doit être l'un des suivants : 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

Facultatifs

Exemple de requête Standard Edit

javascriptCopier
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;

Exemple de requête Pro Edit multi-image

javascriptCopier
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;

Format de la réponse

Réponse initiale

Tous les modèles renvoient un task_id pour le suivi :

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

Réponse de suivi

Interrogez GET /api/v1/image/{task_id} pour vérifier l'état de la tâche :

jsonCopier
{
  "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"
}

Valeurs d'état

• submitted : tâche acceptée
• processing : génération en cours
• succeed : génération terminée avec succès
• failed : échec de la génération

Bonnes pratiques

Conseils pour la génération de texte en image

1. Soyez précis : incluez le sujet, le style, l'éclairage, la composition et les exigences textuelles dans le prompt.
2. Choisissez la résolution : sélectionnez 1k ou 2k selon la résolution de sortie requise.
3. Sélectionnez le format d'image : adaptez le format à la destination, par exemple 16:9 pour les bannières ou 9:16 pour le contenu vertical.
4. Utilisez le seed pour la reproductibilité : définissez un seed fixe lorsque vous avez besoin de paramètres de génération reproductibles.

Conseils pour l'édition d'images

1. Utilisez des instructions claires : décrivez ce qui doit changer et ce qui doit rester cohérent.
2. Ordonnez délibérément les différentes entrées : fournissez 1 à 3 images et expliquez le rôle de chaque référence dans le prompt.
3. Choisissez la résolution de sortie : sélectionnez 1k ou 2k indépendamment des dimensions de l'image d'entrée.
4. Utilisez des entrées de haute qualité : des images sources nettes produisent généralement des résultats d'édition plus contrôlés.