Qwen Image 3.0
qwen/qwen-image-3Qwen Image 3.0 (Qwen-Image-3.0-Pro) est le modèle avancé de génération d'images d'Alibaba pour des visuels réalistes, des mises en page structurées, des détails riches et une typographie de haute qualité. Générez et éditez des images avec un petit texte précis, un rendu multilingue et des compositions complexes via une seule API Qwen Image 3.0.
Aperçu
Qwen Image 3.0 (Qwen-Image-3.0-Pro) est le modèle avancé de génération d'images d'Alibaba pour des visuels réalistes, des mises en page structurées, des détails riches et une typographie de haute qualité. Générez et éditez des images avec un petit texte précis, un rendu multilingue et des compositions complexes via une seule API Qwen Image 3.0.
Authentification
Toutes les requêtes API nécessitent une clé API valide transmise via l'en-tête Authorization avec le schéma Bearer.
Démarrage rapide
Identifiants
Définissez la variable d'environnement RUNBASE_API_KEY.
export RUNBASE_API_KEY=your-api-keyCréer une exécution
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen-image-3",
"input": {
"prompt": "A cinematic product photo of a ceramic lamp"
}
}'Exécutions
Les exécutions sont traitées de manière asynchrone. Soumettez une requête, puis interrogez le résultat.
Créer une exécution
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen-image-3",
"input": { "prompt": "A cinematic product photo of a ceramic lamp" }
}'Obtenir le statut d'exécution
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Obtenir le résultat
Interrogez l'endpoint de statut jusqu'à ce que status soit "succeeded", puis lisez output.urls dans la réponse.
Schéma d'entrée
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| prompt | string | Requis | PromptJusqu'à 3000 caractères |
| aspect_ratio | string | Optionnel | Aspect ratioOptions : 1:12:33:23:44:39:1616:921:9Par défaut : 1:1 |
| resolution | string | Optionnel | ResolutionOptions : 1k2kPar défaut : 1k |
| image_urls | string[] | Optionnel | Reference imagesJusqu'à 14 images |
Schéma de sortie
| Champ | Type | Description |
|---|---|---|
| urls | string[] | URLs des résultats générés |
Erreurs
L'API utilise les codes de statut HTTP standard pour indiquer le succès ou l'échec.
| Code de statut | Description |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

