Guia do modelo

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:

Modelos Qwen Image comparados
ModeloId do modeloFazTamanhosImagens de referênciaPreço a partir deRotas
Qwen Image 3.0qwen-image-3.0texto para imagem, edição1K, 2Katé 3$0.03duas rotas
Qwen Image 3.0 Proqwen-image-3.0-protexto para imagem, edição1K, 2Katé 3$0.04duas rotas
Qwen Image 2.1qwen-image-2.1texto para imagem, edição1K, 2Kuma imagem$0.03uma rota
Qwen Image 2.0qwen-image-2.0texto para imagem, edição1K, 2Kuma imagem$0.03duas rotas
Qwen Image 2.0 Proqwen-image-2.0-protexto para imagem, edição1K, 2Kuma imagem$0.07uma rota
Qwen Imageqwen-imagetexto para imagem, ediçãopadrão do modelouma imagem$0.03uma rota
Qwen Image Editqwen-image-editsomente ediçãopadrão do modelouma imagem$0.04uma 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)

Preço do Qwen Image por imagem e por lote
ModeloTamanhoPor imagem100 imagens1,000 imagens
Qwen Image 3.01K ou 2K$0.03$3.00$30.00
Qwen Image 3.0 Pro1K$0.04$4.00$40.00
Qwen Image 3.0 Pro2K$0.08$8.00$80.00
Qwen Image 2.11K$0.03$3.00$30.00
Qwen Image 2.12K$0.05$5.00$50.00
Qwen Image 2.01K ou 2K$0.03$3.00$30.00
Qwen Image 2.0 Pro1K ou 2K$0.07$7.00$70.00
Qwen Imageum tamanho$0.03$3.00$30.00
Qwen Image Editum 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.

cURL
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"
Python
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.js
// 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);
Resposta
{
  "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:

Corpo da requisição
{
  "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.