Qwen Image 3.0
qwen/qwen-image-3Qwen Image 3.0 (Qwen-Image-3.0-Pro) è il modello avanzato di generazione immagini di Alibaba per visivi realistici, layout strutturati, ricchi dettagli e typography di alta qualità. Genera e modifica immagini con testo piccolo accurato, resa multilingua e composizioni complesse attraverso un'unica Qwen Image 3.0 API.
Panoramica
Qwen Image 3.0 (Qwen-Image-3.0-Pro) è il modello avanzato di generazione immagini di Alibaba per visivi realistici, layout strutturati, ricchi dettagli e typography di alta qualità. Genera e modifica immagini con testo piccolo accurato, resa multilingua e composizioni complesse attraverso un'unica Qwen Image 3.0 API.
Autenticazione
Tutte le richieste API richiedono una chiave API valida passata tramite l'header Authorization con lo schema Bearer.
Avvio rapido
Credenziali
Imposta la variabile d'ambiente RUNBASE_API_KEY.
export RUNBASE_API_KEY=your-api-keyCrea un'esecuzione
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"
}
}'Esecuzioni
Le esecuzioni vengono elaborate in modo asincrono. Invia una richiesta, poi interroga per il risultato.
Crea un'esecuzione
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" }
}'Stato dell'esecuzione
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Ottieni risultato
Interroga l'endpoint di stato finche status non e "succeeded", poi leggi output.urls dalla risposta.
Schema input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| prompt | string | Obbligatorio | PromptFino a 3000 caratteri |
| aspect_ratio | string | Facoltativo | Aspect ratioOpzioni: 1:12:33:23:44:39:1616:921:9Predefinito: 1:1 |
| resolution | string | Facoltativo | ResolutionOpzioni: 1k2kPredefinito: 1k |
| image_urls | string[] | Facoltativo | Reference imagesFino a 14 immagini |
Schema output
| Campo | Tipo | Descrizione |
|---|---|---|
| urls | string[] | URL degli output generati |
Errori
L'API utilizza codici di stato HTTP standard per indicare successo o errore.
| Codice di stato | Descrizione |
|---|---|
| 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 |

