API Qwen-Image 3.0

Genera o modifica un'immagine tramite GoEnhance con il modello qwen-image-3. Usa solo un prompt per la generazione da testo a immagine, oppure aggiungi da uno a tre URL di riferimento per l'editing dell'immagine. GoEnhance fornisce un accesso API indipendente; non è un'API ufficiale di Alibaba né un affiliato di Alibaba.
Crea una chiave API
Scena di studio astratta che rappresenta la generazione tramite API Qwen-Image 3.0

Integra generazione ed editing in un unico flusso di lavoro

Un endpoint, due modalità

Invia una richiesta POST a /api/v1/images/generations con model: qwen-image-3. Fornisci solo un prompt per la generazione da testo a immagine, oppure includi da uno a tre URL di immagini di riferimento accessibili per l'editing. Ogni richiesta restituisce un'immagine.
Oggetti d'arte in vetro in una singola scena di studio che suggeriscono la generazione e l'editing di immagini

Risultati asincroni per progettazione

Un invio riuscito restituisce un img_uuid. Salvalo, esegui il polling di GET /api/v1/jobs/detail o fornisci un URL di callback HTTPS pubblico per ricevere le modifiche di stato di elaborazione, successo e fallimento.
Corridoio dati senza marchio con una scia luminosa continua che rappresenta la consegna asincrona
Convalida i campi documentati prima di inviare un'attività di generazione o modifica.

Parametri API Qwen-Image 3.0

ID modello

Imposta model esattamente sul valore qwen-image-3.

Prompt

Fornisci da 1 a 2000 caratteri che descrivono l'immagine o la modifica desiderata.

Proporzioni

Usa auto o un rapporto documentato da 1:1 fino a 1:8 e 8:1.

Livello di output

Scegli 1K o 2K; il valore predefinito documentato è 2K.

Immagini di riferimento

Facoltativamente, fornisci da uno a tre URL di immagini, ciascuno inferiore a 10 MB, per l'editing.

Controlli del prompt

Facoltativamente, imposta un prompt negativo, un seed e la modalità di estensione del prompt diretta o tramite agente.
Il prezzo si basa sull'output più l'eventuale supplemento per le immagini di riferimento.

Prezzi dell'API Qwen-Image 3.0

Prezzo di output

Ogni output 1K o 2K costa 1,75 token, pari a $0,035 per immagine generata.

Supplemento per riferimento

Ogni immagine di riferimento aggiunge 0,19 token, pari a 0,0039 $ per immagine di riferimento.

Contabilità delle attività

Una richiesta con due riferimenti costa 2,13 token: 1,75 + (2 × 0,19).

Integra l'API Qwen-Image 3.0

1

Crea la richiesta

Invia le tue credenziali API nell'intestazione Authorization, quindi effettua una richiesta POST con un corpo JSON contenente model e prompt. Aggiungi rapporto d'aspetto, dimensioni dell'immagine o URL di riferimento solo quando necessario.
2

Conserva l'ID attività

Controlla la presenza di code: 0 e memorizza l'img_uuid restituito. Tratta le risposte di token insufficienti e di autenticazione come errori anziché come risultati dell'immagine.
3

Risolvi il completamento

Esegui il polling dell'endpoint dei dettagli del lavoro o utilizza un callback HTTPS pubblico. Accetta l'asset solo dopo che l'attività ha raggiunto lo stato di successo; gestisci esplicitamente lo stato di errore.
Crea una chiave API
Aggiungi la generazione di immagini e le modifiche controllate ai flussi di lavoro di produzione senza dover costruire uno stack di servizio per il modello.

Casi d'uso per sviluppatori

Visual di prodotto

Crea concept di prodotto pronti per le campagne a partire da prompt strutturati.

Variazioni creative

Genera nuove direzioni visive per annunci, post e landing page.

Modifiche guidate da riferimento

Trasforma da uno a tre riferimenti forniti preservando l'intento del prompt.

Campagne localizzate

Produci concept visivi specifici per il mercato a partire da brief creativi localizzati.

Pipeline di asset

Metti in coda lavori di generazione asincroni all'interno di flussi di lavoro di contenuti automatizzati.

Prototipazione di design

Esplora idee di composizione, materiale e colore prima della produzione finale.
Risposte alle domande comuni su prezzi, input e integrazione.

FAQ sull'API di Qwen-Image 3.0

Qual è l'endpoint dell'API Qwen-Image 3.0?

Invia richieste POST a https://api.goenhance.ai/api/v1/images/generations con model: qwen-image-3.

Quanto costa l'API Qwen-Image 3.0?

Il prezzo di output documentato è di 1,75 token, o 0,035 $, sia per 1K che per 2K. Ogni immagine di riferimento aggiunge 0,19 token, o 0,0039 $.

L'API può modificare immagini esistenti?

Sì. Aggiungi image_list con da uno a tre URL di immagini accessibili, ciascuno inferiore a 10 MB. Ometti il campo per la generazione puramente da testo a immagine.

Quali rapporti d'aspetto sono supportati?

L'API supporta auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 1:2, 2:1, 1:4, 4:1, 1:8 e 8:1. Gli output 1:8 e 8:1 sono limitati al livello 1K.

Come funzionano i callback?

Fornisci un URL di callback HTTPS accessibile pubblicamente. GoEnhance invia le modifiche di elaborazione, successo e fallimento utilizzando il formato di risposta dei dettagli del lavoro. I callback che non restituiscono 200 vengono riprovati fino a tre volte con un timeout di tre secondi per tentativo.

Si tratta di un'API ufficiale di Alibaba?

No. Qwen è associato ad Alibaba, mentre questo endpoint è fornito indipendentemente da GoEnhance. Non implica una partnership o un'approvazione da parte di Alibaba. Per un servizio gestito da Alibaba, consulta la documentazione di Alibaba Cloud.

Inizia a sviluppare con Qwen-Image 3.0