API do Qwen Image: versões, preços e código
Os modelos Qwen Image da Alibaba são uma escolha de baixo custo para imagens com texto em vários idiomas e para edições por instrução. Este guia cobre as sete versões na Revana, quanto cada uma custa e como chamá-las.
Todos os modelos Qwen Image do catálogo
O Qwen Image é a família de imagem da Alibaba. É conhecido por renderizar texto dentro das imagens, em chinês e em inglês, e por seguir de perto instruções de edição. A Revana oferece sete versões, todas no mesmo formato de requisição:
| Modelo | Id do modelo | Faz | Tamanhos | Imagens de referência | Preço a partir de | Rotas |
|---|---|---|---|---|---|---|
| Qwen Image 3.0 | qwen-image-3.0 | texto para imagem, edição | 1K, 2K | até 3 | $0.03 | duas rotas |
| Qwen Image 3.0 Pro | qwen-image-3.0-pro | texto para imagem, edição | 1K, 2K | até 3 | $0.04 | duas rotas |
| Qwen Image 2.1 | qwen-image-2.1 | texto para imagem, edição | 1K, 2K | uma imagem | $0.03 | uma rota |
| Qwen Image 2.0 | qwen-image-2.0 | texto para imagem, edição | 1K, 2K | uma imagem | $0.03 | duas rotas |
| Qwen Image 2.0 Pro | qwen-image-2.0-pro | texto para imagem, edição | 1K, 2K | uma imagem | $0.07 | uma rota |
| Qwen Image | qwen-image | texto para imagem, edição | padrão do modelo | uma imagem | $0.03 | uma rota |
| Qwen Image Edit | qwen-image-edit | somente edição | padrão do modelo | uma imagem | $0.04 | uma rota |
Os preços são por imagem. Em um projeto novo, comece pelo Qwen Image 3.0: é o nível padrão mais novo, aceita até três imagens de referência e custa $0.03 em 2K e também em 1K. Passe para o 3.0 Pro se o nível padrão deixar escapar detalhes de que você precisa, e mantenha as versões mais antigas para prompts que você já ajustou.
Preços do Qwen Image (outubro de 2026)
| Modelo | Tamanho | Por imagem | 100 imagens | 1,000 imagens |
|---|---|---|---|---|
| Qwen Image 3.0 | 1K ou 2K | $0.03 | $3.00 | $30.00 |
| Qwen Image 3.0 Pro | 1K | $0.04 | $4.00 | $40.00 |
| Qwen Image 3.0 Pro | 2K | $0.08 | $8.00 | $80.00 |
| Qwen Image 2.1 | 1K | $0.03 | $3.00 | $30.00 |
| Qwen Image 2.1 | 2K | $0.05 | $5.00 | $50.00 |
| Qwen Image 2.0 | 1K ou 2K | $0.03 | $3.00 | $30.00 |
| Qwen Image 2.0 Pro | 1K ou 2K | $0.07 | $7.00 | $70.00 |
| Qwen Image | um tamanho | $0.03 | $3.00 | $30.00 |
| Qwen Image Edit | um tamanho | $0.04 | $4.00 | $40.00 |
Dois detalhes de preço passam facilmente despercebidos. O Qwen Image 3.0 cobra o mesmo em 1K e 2K, então não há motivo para pedir o tamanho menor. O Qwen Image 3.0 Pro dobra de 1K para 2K, então faça rascunhos em 1K e renderize as escolhidas em 2K. Imagens que falham nunca são cobradas.
Para que o Qwen Image serve
- Texto em outros idiomas além do inglês. Placas de lojas, cardápios, rótulos e pôsteres em chinês, ou chinês e inglês na mesma imagem.
- Edições por instrução. "Troque a jaqueta para vermelho", "remova a pessoa à esquerda", "substitua o texto da placa por OPEN". O Qwen Image Edit faz só isso; as versões mais novas fazem isso e também texto para imagem.
- Baixo custo por imagem. A $0.03 por imagem, o Qwen Image 3.0 é uma das formas mais baratas de criar grandes lotes de variações de marketing.
Não publicamos notas de qualidade. Para layouts em inglês com muito texto, compare com GPT Image 2 e Nano Banana Pro usando seus próprios prompts antes de se comprometer.
Gere uma imagem com o Qwen Image 3.0
Envie POST /v1/generations com o id do modelo e um input, depois consulte a geração. Esta imagem em 2K custa $0.03.
export REVANA_API_KEY="sr_live_..."
# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-3.0",
"input": {
"prompt": "A night street in Shanghai, a small noodle shop with a red paper lantern. The wooden sign above the door reads 老街面馆 in brush calligraphy. Light rain, reflections on the pavement.",
"resolution": "2K"
},
"max_cost_usd": 0.1
}'
# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
-H "Authorization: Bearer $REVANA_API_KEY"import os
import time
import requests
API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}
resp = requests.post(f"{API}/generations", headers=HEADERS, json={
"model": "qwen-image-3.0",
"input": {
"prompt": "A night street in Shanghai, a small noodle shop with a red paper lantern. The wooden sign above the door reads 老街面馆 in brush calligraphy. Light rain, reflections on the pavement.",
"resolution": "2K",
},
"max_cost_usd": 0.1,
})
resp.raise_for_status()
job = resp.json()
while job["status"] in ("queued", "running"):
time.sleep(3)
job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
if job["status"] == "succeeded":
print(job["output"]["urls"], job["cost_usd"])
else:
print("Failed:", job["error"])// Node 18 or later. Save as generate.mjs and run: node generate.mjs
const API = "https://api.revana.si/v1";
const headers = {
Authorization: `Bearer ${process.env.REVANA_API_KEY}`,
"Content-Type": "application/json",
};
const res = await fetch(`${API}/generations`, {
method: "POST",
headers,
body: JSON.stringify({
model: "qwen-image-3.0",
input: {
prompt: "A night street in Shanghai, a small noodle shop with a red paper lantern. The wooden sign above the door reads 老街面馆 in brush calligraphy. Light rain, reflections on the pavement.",
resolution: "2K",
},
max_cost_usd: 0.1,
}),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
let job = await res.json();
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await (await fetch(`${API}/generations/${job.id}`, { headers })).json();
}
if (job.status === "succeeded") console.log(job.output.urls, job.cost_usd);
else console.error("Failed:", job.error);{
"id": "gen_01JC2V8K5T",
"model": "qwen-image-3.0",
"status": "succeeded",
"output": {
"urls": [
"https://cdn.revana.si/g/gen_01JC2V8K5T/0.png"
]
},
"cost_usd": 0.03,
"attempts": 1,
"error": null,
"created_at": "2026-10-28T10:14:02Z",
"completed_at": "2026-10-28T10:15:31Z"
}Edite uma imagem com uma instrução
Para uma edição, envie a imagem e diga o que mudar. O Qwen Image 3.0 e o 3.0 Pro aceitam até três imagens em image_urls; as outras versões aceitam uma, em image_url. Esta edição no Qwen Image Edit custa $0.04:
{
"model": "qwen-image-edit",
"input": {
"prompt": "Replace the text on the shop sign with FRESH BREAD DAILY, in the same font and colour. Change nothing else.",
"image_url": "https://example.com/bakery-front.jpg"
},
"max_cost_usd": 0.1
}Enviar mais imagens do que um modelo aceita é recusado na hora com 422 invalid_input, e a mensagem informa o limite. Nada é cobrado por uma requisição recusada.
Todas as versões Qwen estão na página de modelos, com a referência de requisições na documentação e os pacotes de créditos na página de preços. Obtenha uma chave de API para rodar os exemplos.
Perguntas frequentes
Quanto custa a API do Qwen Image?
Em outubro de 2026, o Qwen Image 3.0 custa $0.03 por imagem em 1K ou 2K, o Qwen Image 3.0 Pro custa $0.04 em 1K e $0.08 em 2K, e o Qwen Image Edit custa $0.04 por edição.
Qual versão do Qwen Image devo usar?
Comece pelo Qwen Image 3.0. É o nível padrão mais novo, aceita até três imagens de referência e custa o mesmo em 1K e 2K. Experimente o 3.0 Pro quando precisar de mais detalhe.
O Qwen Image renderiza texto em chinês?
Sim. Renderizar texto em chinês e em inglês é o que a família Qwen Image tem de mais conhecido. Coloque os caracteres exatos no prompt e confira o resultado antes de publicar.
Qual é a diferença entre o Qwen Image e o Qwen Image Edit?
O Qwen Image Edit só edita uma imagem que você envia. As outras versões do Qwen Image criam imagens a partir de um prompt e também editam.
Quantas imagens posso enviar ao Qwen Image 3.0?
Até três, em image_urls. As versões mais antigas aceitam uma imagem, em image_url.
Experimente o Qwen Image com uma só chave
Uma chave de API para todas as versões do Qwen Image e todos os outros modelos de imagem e vídeo. Crédito pré-pago a partir de $10, cobrado apenas pelas imagens entregues.