Qwen Image 3.0 API
Alibaba Qwen Image 3.0 — endpoint Standard e Pro per text-to-image e image-edit, con proporzioni flessibili, output 1K/2K e comprensione delle istruzioni in linguaggio naturale.
Qwen Image 3.0 offre endpoint Standard e Pro per text-to-image ed editing. Scegli il livello Standard per generazione ed editing 1K/2K coerenti, oppure Pro per un output a fedeltà più alta con prezzi in base alla risoluzione.
/filters:quality(82)/examples/97938534229240bdb8457c6ae2c22e1b/1-1041bd7755e3.webp)
Panoramica
Informazioni su Qwen Image 3.0 API
Cosa fa Qwen Image 3.0, come si inserisce nella gamma di modelli di Alibaba e perché i team lo scelgono.
Qwen Image 3.0 è un modello di generazione e modifica di immagini di Alibaba, disponibile tramite l'API REST di WaveSpeedAI. Alibaba Qwen Image 3.0 — endpoint Standard e Pro per text-to-image e image-edit, con proporzioni flessibili, output 1K/2K e comprensione delle istruzioni in linguaggio naturale.
Qwen Image 3.0 offre endpoint Standard e Pro per text-to-image ed editing. Scegli il livello Standard per generazione ed editing 1K/2K coerenti, oppure Pro per un output a fedeltà più alta con prezzi in base alla risoluzione.
La famiglia Qwen Image 3.0 su WaveSpeedAI offre 4 endpoint REST che coprono i flussi di lavoro Text-To-Image, Image-To-Image. Ogni variante ha il suo prezzo, i suoi parametri e i suoi esempi di output: scegli quella più adatta alla tua modalità di input e ai tuoi vincoli di produzione, oppure richiamane diverse con la stessa chiave API per comporre pipeline in più passaggi.
Usa Qwen Image 3.0 con la stessa chiave API, lo stesso account di fatturazione e gli stessi limiti di frequenza che usi per gli altri oltre 1.000 modelli AI di WaveSpeedAI. Nessuna configurazione separata per fornitore, nessun SDK per provider, nessun limite di frequenza per fornitore: un'unica integrazione copre tutto, dal text-to-image e text-to-video alla sintesi audio, alla generazione 3D, all'upscaling e all'editing.
Endpoint
Tutti gli endpoint API Qwen Image 3.0
4 endpoint Qwen Image 3.0 disponibili ora su WaveSpeedAI: scegli la variante più adatta al tuo flusso di lavoro.
/filters:quality(82)/media/images/1785949826547283917_F8QZ8hqB.webp)
Qwen Image 3.0 Text To Image
Qwen Image 3.0 Text to Image is a high-quality image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785949851816447753_YuENW5PZ.webp)
Qwen Image 3.0 Edit
Qwen Image 3.0 Edit is a high-quality image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785950638933780388_UpyHQ09J.webp)
Qwen Image 3.0 Pro Text To Image
Qwen Image 3.0 Pro Text-to-Image is a professional-grade image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785950659359092904_wW4uENW5.webp)
Qwen Image 3.0 Pro Edit
Qwen Image 3.0 Pro Edit is a professional-grade image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Esempi
Qwen Image 3.0 in azione
Output reali generati dall'API Qwen Image 3.0. Passa il mouse su un video per l'anteprima, clicca per aprire il visualizzatore a schermo intero.
Guida
Come usare l'API Qwen Image 3.0
Quattro passaggi dalla registrazione alla generazione completata. Esempi completi in Python, Node.js e cURL sono nella sezione API qui sotto.
- 01
Ottieni una chiave API
Registrati su WaveSpeedAI e copia la tua chiave API dalla dashboard. I nuovi account includono crediti gratuiti di benvenuto: bastano per usare il playground qualche decina di volte prima che inizi la fatturazione.
- 02
Invia una predizione
Invia con POST il tuo input in formato JSON a https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image. L'endpoint restituisce subito un id di predizione: le generazioni sono asincrone, quindi non devi tenere una connessione aperta durante l'inferenza.
- 03
Controlla il completamento
Fai GET su https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Restituisci gli output con completed; interrompi con un errore con failed, cancelled, timeout o deleted; continua il polling per ogni altro stato.
- 04
Leggi l'URL dell'output
Quando lo stato è "completed", leggi l'URL da data.outputs[0]. L'URL punta al tuo contenuto generato sulla CDN di WaveSpeedAI: immagine, video, audio o file 3D a seconda della variante di Qwen Image 3.0 che hai richiamato.
Casi d'uso
Cosa puoi creare con Qwen Image 3.0
I flussi di lavoro più comuni per cui sviluppatori e creator usano l'API Qwen Image 3.0.
Generazione text-to-image Standard
alibaba/qwen-image-3.0/text-to-image crea immagini da prompt in linguaggio naturale con proporzioni flessibili e livelli di risoluzione 1K o 2K.
Generazione di immagini Pro per il lavoro di produzione
alibaba/qwen-image-3.0-pro/text-to-image offre il livello di generazione Pro per creazioni visive dettagliate, aderenza al prompt e output di produzione a fedeltà più alta.
Image editing in linguaggio naturale
Gli endpoint edit Standard e Pro trasformano da 1 a 3 immagini di riferimento con istruzioni in linguaggio naturale, preservando il contesto visivo richiesto.
Workflow creativi attenti alla risoluzione
Seleziona output 1K o 2K e scegli una proporzione prima della generazione o dell'editing per adattarti ai workflow di marketing, prodotto, ritratto e consegna creativa.
Consigli
Consigli per scrivere i prompt per Qwen Image 3.0
Consigli pratici per ottenere output migliori da Qwen Image 3.0, ricavati dagli schemi che funzionano con i modelli immagini nelle pipeline di produzione.
- 01
Descrivi illuminazione, composizione e stile — non solo il soggetto
Vai oltre «un gatto» verso «un gatto tigrato su un davanzale, morbida luce pomeridiana che entra, profondità di campo ridotta, composizione cinematografica 35mm». Soggetto + scena + illuminazione + linguaggio di camera è la formula di prompt che attinge meglio dai dati di addestramento dei modelli di immagini.
- 02
Usa ancore di stile anziché nomi di artisti
«Nello stile della fotografia editoriale» o «foto di prodotto in studio, sfondo bianco continuo» batte il vago boilerplate «high quality, masterpiece» E evita i problemi legali / di licenza che comporta nominare artisti viventi nel lavoro commerciale.
- 03
Specifica esplicitamente risoluzione e proporzioni
Non affidarti ai valori predefiniti. Imposta subito proporzioni (1:1, 4:3, 16:9) e risoluzione di destinazione. Ritagliare o ingrandire dopo fa perdere una fedeltà che il modello avrebbe potuto collocare correttamente fin dalla prima generazione.
- 04
Itera su un seed bloccato prima di rilanciare
Blocca il seed e cambia un solo elemento del prompt alla volta. Molto più rapido che rilanciare seed casuali a ogni modifica — isoli causa ed effetto di ogni cambiamento al prompt e raggiungi l'immagine desiderata con meno generazioni totali.
- 05
Usa l'endpoint edit per le rifiniture, non una rigenerazione completa
Genera l'immagine di base una volta, poi usa l'endpoint edit / inpaint del modello per rifinire elementi specifici — testo, illuminazione, singoli soggetti. Le modifiche preservano tutto ciò che ti piaceva della base e costano meno per iterazione delle rigenerazioni complete.
Prezzi
Prezzi dell'API Qwen Image 3.0
Il prezzo è per output. L'addebito finale dipende dai parametri impostati nel playground di ciascuna variante (risoluzione, durata, numero di output, riferimenti).
| Endpoint | Tipo | Prezzo di partenza |
|---|---|---|
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | image-to-image | $0.03 |
| alibaba/ | text-to-image | $0.04 |
| alibaba/ | image-to-image | $0.04 |
API
Richiama l'API Qwen Image 3.0
Ottieni una chiave API su wavespeed.ai/accesskey, poi invia una predizione tramite REST. Il playground genera esempi pronti da incollare per qualsiasi combinazione di input.
POSThttps://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Confronto
Qwen Image 3.0 a confronto con le alternative
Quando scegliere Qwen Image 3.0 rispetto a modelli simili su WaveSpeedAI.
Qwen Image 3.0 vs Seedream 5 Pro
Seedream 5 Pro punta su comprensione del design, editing multi-riferimento e controlli sul formato di output. Qwen Image 3.0 offre una gamma mirata Standard/Pro con generazione ed editing in linguaggio naturale sui livelli 1K e 2K.
Qwen Image 3.0 vs Qwen Image 2.0
Qwen Image 2.0 è la gamma di generazione ed editing della precedente generazione della famiglia Qwen. Qwen Image 3.0 usa endpoint Alibaba Standard e Pro dedicati, con comportamento di generazione ed editing aggiornato.
FAQ
Qwen Image 3.0 API — Domande frequenti
Prezzi, licenza, integrazione: le domande più comuni sull'uso di Qwen Image 3.0 su WaveSpeedAI.
Che cos'è l'API Qwen Image 3.0?
Qwen Image 3.0 è un modello di generazione di immagini di Alibaba reso disponibile come API REST su WaveSpeedAI. Alibaba Qwen Image 3.0 — endpoint Standard e Pro per text-to-image e image-edit, con proporzioni flessibili, output 1K/2K e comprensione delle istruzioni in linguaggio naturale. Puoi richiamarlo da codice o provarlo dal playground collegato qui sopra.
Come richiamo l'API Qwen Image 3.0?
Registrati su WaveSpeedAI, copia la tua chiave API da /accesskey, poi invia con POST a https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image il tuo input in formato JSON. L'endpoint restituisce un id di predizione. Fai polling sull'endpoint dei risultati circa ogni 2 secondi, aumenta l'intervallo per le attività di lunga durata e fermati a qualsiasi stato terminale. Gli esempi in Python / Node.js / cURL orientati alla produzione sono qui sopra.
Quanto costa l'API Qwen Image 3.0?
Qwen Image 3.0 parte da $0.03. Il costo esatto dipende dai parametri impostati (risoluzione, durata, numero di output, riferimenti). L'anteprima del costo in tempo reale accanto al pulsante Genera nel playground mostra il prezzo esatto per il tuo input attuale.
Quali varianti di Qwen Image 3.0 sono disponibili?
WaveSpeedAI offre 4 endpoint Qwen Image 3.0 attivi: alibaba/qwen-image-3.0/text-to-image, alibaba/qwen-image-3.0/edit, alibaba/qwen-image-3.0-pro/text-to-image, alibaba/qwen-image-3.0-pro/edit. Ogni variante ha la sua pagina playground e i suoi prezzi.
Posso usare gli output di Qwen Image 3.0 a fini commerciali?
I diritti di uso commerciale seguono la licenza del modello di Alibaba. La maggior parte dei modelli di Alibaba consente l'uso commerciale degli output; consulta la pagina playground di ciascun modello per il riepilogo della licenza e i Termini di servizio di WaveSpeedAI per le condizioni a livello di piattaforma.
Perché usare Qwen Image 3.0 su WaveSpeedAI invece di rivolgersi direttamente al fornitore?
Una sola chiave API e un solo account di fatturazione per Qwen Image 3.0 E per oltre 1.000 altri modelli AI di altri provider. Nessuna configurazione di SDK per fornitore, nessun limite di frequenza separato, nessun codice di integrazione da riscrivere per ogni fornitore. I prezzi sono in genere in linea o inferiori a quelli dell'API diretta di Alibaba.
Provider
Informazioni su Alibaba
Il team dietro Qwen Image 3.0 e dietro l'intera gamma di modelli di Alibaba su WaveSpeedAI.
Il Tongyi Lab di Alibaba produce la famiglia di modelli video Wan e la famiglia di LLM Qwen. Wan si distingue per il rilascio con pesi aperti, un'ampia copertura di varianti (text-to-video, image-to-video, reference-to-video, video-edit, video-extend, image-edit, text-to-image) e una costante solidità in stabilità del movimento e aderenza al prompt con prompt multilingue.
Inizia a creare con Qwen Image 3.0 su WaveSpeedAI
Crediti gratuiti di benvenuto alla registrazione. Una sola chiave API per oltre 1.000 modelli AI di Alibaba e di ogni altro provider.
/filters:quality(82)/examples/e699bbebd6bdb91b0997ad00a6db5927/1-a0b53b852c48.webp)
/filters:quality(82)/examples/861c63aed61c2671fa3f2cc5446a7fc9/1-9313861ab37e.webp)
/filters:quality(82)/examples/aa6aaaad4738a37e20a331f53432e66e/1-3808e66eb793.webp)
/filters:quality(82)/examples/b01c4177aa64d5a63f66b59f28e734f2/1-f943c79cfc64.webp)