Qwen Image 3.0 API
Alibaba Qwen Image 3.0 — endpoints Standard e Pro de texto para imagem e image-edit, com proporções de tela flexíveis, saída em 1K/2K e compreensão de instruções em linguagem natural.
O Qwen Image 3.0 oferece endpoints Standard e Pro de texto para imagem e edição. Escolha o nível Standard para geração e edição consistentes em 1K/2K, ou o Pro para saída de maior fidelidade com preço por resolução.
/filters:quality(82)/examples/97938534229240bdb8457c6ae2c22e1b/1-1041bd7755e3.webp)
Visão geral
Sobre o Qwen Image 3.0 API
O que o Qwen Image 3.0 faz, como ele se encaixa na linha de modelos da Alibaba e por que as equipes o escolhem.
Qwen Image 3.0 é um modelo de geração e edição de imagens da Alibaba, disponível pela API REST da WaveSpeedAI. Alibaba Qwen Image 3.0 — endpoints Standard e Pro de texto para imagem e image-edit, com proporções de tela flexíveis, saída em 1K/2K e compreensão de instruções em linguagem natural.
O Qwen Image 3.0 oferece endpoints Standard e Pro de texto para imagem e edição. Escolha o nível Standard para geração e edição consistentes em 1K/2K, ou o Pro para saída de maior fidelidade com preço por resolução.
A família Qwen Image 3.0 na WaveSpeedAI traz 4 endpoints REST cobrindo os fluxos de Text-To-Image, Image-To-Image. Cada variante tem seu próprio preço, parâmetros e exemplos de resultado — escolha a que combina com sua modalidade de entrada e suas restrições de produção, ou chame várias com a mesma chave de API para montar pipelines de várias etapas.
Execute o Qwen Image 3.0 com a mesma chave de API, a mesma conta de cobrança e os mesmos limites de taxa que você usa nos outros mais de 1.000 modelos de IA da WaveSpeedAI. Sem configuração separada por fornecedor, sem SDKs por provedor, sem limites de taxa por fornecedor — uma única integração cobre tudo, de texto para imagem e texto para vídeo até síntese de áudio, geração 3D, ampliação e edição.
Endpoints
Todos os endpoints da API de Qwen Image 3.0
4 endpoints de Qwen Image 3.0 disponíveis agora na WaveSpeedAI — escolha a variante que combina com seu fluxo de trabalho.
/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.
Exemplos
Veja o Qwen Image 3.0 em ação
Resultados reais gerados pela API do Qwen Image 3.0. Passe o mouse sobre qualquer vídeo para pré-visualizar e clique para abrir o visualizador em tamanho real.
Como usar
Como usar a API do Qwen Image 3.0
Quatro passos do cadastro até uma geração concluída. Exemplos completos em Python, Node.js e cURL estão na seção de API abaixo.
- 01
Obtenha uma chave de API
Crie uma conta na WaveSpeedAI e copie sua chave de API no painel. Contas novas recebem créditos iniciais grátis — o suficiente para usar o playground algumas dezenas de vezes antes de a cobrança começar.
- 02
Envie uma predição
Faça POST da sua entrada em JSON para https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image. O endpoint devolve um id de predição imediatamente — as gerações são assíncronas, então você não mantém uma conexão aberta durante a inferência.
- 03
Consulte até concluir
Faça GET em https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retorne os resultados quando o status for completed; pare com erro em failed, cancelled, timeout ou deleted; continue consultando em qualquer outro status.
- 04
Leia a URL do resultado
Quando o status for "completed", leia a URL em data.outputs[0]. A URL aponta para a mídia gerada na CDN da WaveSpeedAI — imagem, vídeo, áudio ou arquivo 3D, conforme a variante do Qwen Image 3.0 que você chamou.
Casos de uso
O que você pode criar com o Qwen Image 3.0
Fluxos de trabalho comuns para os quais desenvolvedores e criadores usam a API do Qwen Image 3.0.
Geração padrão de texto para imagem
alibaba/qwen-image-3.0/text-to-image cria imagens a partir de prompts em linguagem natural, com proporções de tela flexíveis e níveis de resolução de 1K ou 2K.
Geração de imagens Pro para trabalho de produção
alibaba/qwen-image-3.0-pro/text-to-image oferece o nível Pro de geração para criação visual detalhada, aderência ao prompt e saída de produção de maior fidelidade.
Edição de imagens em linguagem natural
Os endpoints de edição Standard e Pro transformam de 1 a 3 imagens de referência com instruções em linguagem natural, preservando o contexto visual solicitado.
Workflows criativos conscientes da resolução
Selecione a saída em 1K ou 2K e escolha uma proporção de tela antes da geração ou da edição, para atender workflows de marketing, produto, retrato e entrega criativa.
Dicas
Dicas de prompt para o Qwen Image 3.0
Conselhos práticos para obter melhores resultados com o Qwen Image 3.0 — extraídos dos padrões que funcionam em modelos de imagem em pipelines de produção.
- 01
Descreva iluminação, composição e estilo — não apenas o sujeito
Vá além de "a cat" e escreva "a tabby cat on a windowsill, soft afternoon light streaming in, shallow depth of field, cinematic 35mm composition". Sujeito + cena + iluminação + linguagem de câmera é a fórmula de prompt que melhor aproveita os dados de treinamento dos modelos de imagem.
- 02
Use âncoras de estilo em vez de nomes de artistas
"In the style of editorial photography" ou "studio product shot, white seamless background" é melhor do que fórmulas vagas como "high quality, masterpiece" E evita as questões legais e de licenciamento de citar artistas vivos em trabalho comercial.
- 03
Especifique resolução e proporção de tela explicitamente
Não dependa dos padrões. Defina de antemão a proporção de tela desejada (1:1, 4:3, 16:9) e a resolução. Recortar ou ampliar depois perde a fidelidade que o modelo poderia ter colocado no lugar certo já na primeira geração.
- 04
Itere com uma seed fixa antes de sortear de novo
Fixe a seed e mude um elemento do prompt por vez. Muito mais rápido do que sortear seeds aleatórias a cada alteração — você isola causa e efeito em cada edição do prompt e chega à imagem desejada com menos gerações no total.
- 05
Use o endpoint de edição para refinamentos, não a geração completa de novo
Gere a imagem base uma vez e depois use o endpoint de edição / inpaint do modelo para refinar elementos específicos — texto, iluminação, sujeitos individuais. As edições preservam tudo o que você gostou na base e custam menos por iteração do que gerações completas.
Preços
Preços da API de Qwen Image 3.0
O preço é por resultado. O valor final varia conforme os parâmetros definidos no playground de cada variante (resolução, duração, quantidade de resultados, referências).
| Endpoint | Tipo | Preço inicial |
|---|---|---|
| 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
Chame a API de Qwen Image 3.0
Crie uma chave de API em wavespeed.ai/accesskey e envie uma predição via REST. O playground gera exemplos prontos para colar para qualquer combinação de entradas.
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)Comparar
Qwen Image 3.0 vs alternativas
Quando escolher o Qwen Image 3.0 em vez de modelos semelhantes na WaveSpeedAI.
Qwen Image 3.0 vs Seedream 5 Pro
O Seedream 5 Pro prioriza a compreensão de design, a edição com várias referências e os controles de formato de saída. O Qwen Image 3.0 oferece uma superfície enxuta Standard/Pro, com geração e edição em linguagem natural nos níveis 1K e 2K.
Qwen Image 3.0 vs Qwen Image 2.0
O Qwen Image 2.0 é a geração anterior da família Qwen, com sua superfície de geração e edição. O Qwen Image 3.0 usa endpoints dedicados Standard e Pro da Alibaba, com comportamento de geração e edição atualizado.
FAQ
Qwen Image 3.0 API — Perguntas frequentes
Preços, licença, integração — perguntas comuns sobre executar o Qwen Image 3.0 na WaveSpeedAI.
O que é a API do Qwen Image 3.0?
Qwen Image 3.0 é um modelo de geração de imagens da Alibaba disponibilizado como API REST na WaveSpeedAI. Alibaba Qwen Image 3.0 — endpoints Standard e Pro de texto para imagem e image-edit, com proporções de tela flexíveis, saída em 1K/2K e compreensão de instruções em linguagem natural. Você pode chamá-lo por código ou testá-lo no playground indicado acima.
Como chamo a API do Qwen Image 3.0?
Crie uma conta na WaveSpeedAI, copie sua chave de API em /accesskey e faça POST para https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image com sua entrada em JSON. O endpoint devolve um id de predição. Consulte o endpoint de resultado a cada 2 segundos, aproximadamente, aumente o intervalo em tarefas longas e pare em qualquer status final. Exemplos prontos para produção em Python / Node.js / cURL estão acima.
Quanto custa a API do Qwen Image 3.0?
O Qwen Image 3.0 começa em $0.03. O custo exato varia conforme os parâmetros definidos (resolução, duração, quantidade de resultados, referências). A prévia de custo ao vivo ao lado do botão Gerar no playground mostra o preço exato da sua entrada atual.
Quais variantes do Qwen Image 3.0 estão disponíveis?
A WaveSpeedAI hospeda 4 endpoints de Qwen Image 3.0 ativos: 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. Cada variante tem sua própria página de playground e seu preço.
Posso usar os resultados do Qwen Image 3.0 comercialmente?
Os direitos de uso comercial seguem a licença do modelo da Alibaba. A maioria dos modelos da Alibaba permite o uso comercial dos resultados; veja o resumo da licença na página do playground de cada modelo e os Termos de Serviço da WaveSpeedAI para as condições da plataforma.
Por que usar o Qwen Image 3.0 na WaveSpeedAI em vez de ir direto à fonte?
Uma chave de API e uma conta de cobrança para o Qwen Image 3.0 E mais de 1.000 outros modelos de IA de outros provedores. Sem configuração de SDK por fornecedor, sem limites de taxa separados, sem reescrever o código de integração a cada fornecedor. Os preços costumam ser iguais ou menores que os da API direta da Alibaba.
Provedor
Sobre a Alibaba
A equipe por trás do Qwen Image 3.0 e de toda a linha de modelos da Alibaba na WaveSpeedAI.
O Tongyi Lab da Alibaba produz a família de modelos de vídeo Wan e a família de LLMs Qwen. O Wan se destaca por ter sido lançado com pesos abertos, ampla cobertura de variantes (texto para vídeo, imagem para vídeo, referência para vídeo, video-edit, video-extend, image-edit, texto para imagem) e força constante em estabilidade de movimento e aderência ao prompt com prompts em vários idiomas.
Comece a criar com o Qwen Image 3.0 na WaveSpeedAI
Créditos iniciais grátis no cadastro. Uma chave de API para mais de 1.000 modelos de IA da Alibaba e de todos os outros provedores.
/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)