Família Qwen-Image
Os modelos de imagem Tongyi da Alibaba, dois no total. São chamados pelo endpoint compatível com OpenAI /v1/images/generations, que é usado tanto para texto para imagem quanto para edição.
Escolha de modelo
Os dois têm exatamente os mesmos parâmetros. O Pro é a versão premium, com melhor renderização de texto e melhor acabamento visual.
qwen/qwen-image-3.0-proNível premiumqwen/qwen-image-3.0Nível padrãoPreços atuais na página do modelo .
Diferenças em relação a outras famílias
Validade do link: o parâmetro Expires do link corresponde a 24 horas após a geração. Para uso prolongado, baixe e armazene a imagem o quanto antes; não grave o link diretamente no banco de dados.
Texto para imagem
Python
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
resp = client.images.generate(
model="qwen/qwen-image-3.0-pro",
prompt="Uma maçã vermelha sobre uma mesa branca, ao lado de um cartão escrito “OfoxAI”",
size="1024x1024",
)
# O retorno é um link temporário; baixe a imagem em até 24 horas
urllib.request.urlretrieve(resp.data[0].url, "output.png")Tamanho e quantidade
n é 6.Em nossas medições, 2560x1440 funciona. Quanto à latência, 1024×1024 leva cerca de 10 a 60 segundos, 2560×1440 cerca de 60 segundos e a edição cerca de 50 a 100 segundos. Recomenda-se definir o timeout do cliente em 300 segundos ou mais.
Edição e várias imagens de referência
input_images, até 3; o campo image não é usado, e /v1/images/edits não é suportado.Python
import base64
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
with open("apple.jpg", "rb") as f:
ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
resp = client.images.generate(
model="qwen/qwen-image-3.0-pro",
prompt="Deixe a maçã roxa e mantenha todo o resto igual",
extra_body={"input_images": [ref]},
)
urllib.request.urlretrieve(resp.data[0].url, "apple_purple.png")input_imagesé um array; cada item é uma URL de imagem ou uma string iniciada pordata:image/...;base64,, com 1 a 3 imagens. Mais de 3 imagens retorna 400.imageé um campo exclusivo do Seedream e não é suportado pelo Qwen-Image.- Na edição, se
sizefor omitido, a saída medida é 2048×2048, que pode ser diferente da imagem original. Para manter o tamanho, informe-o explicitamente.
Outros parâmetros
Em nossas medições, negative_prompt (o que não deve aparecer) e prompt_extend (se o modelo deve expandir o prompt automaticamente) podem ser enviados normalmente. Definição dos parâmetros na documentação oficial do Alibaba Cloud Model Studio .
Erros comuns
O qwen-image-3.0-distill nas mensagens de erro é o nome interno do modelo upstream; nas chamadas, continue usando os IDs de modelo listados nesta página.
Mensagens de erro originais
Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requests. Got area=10000 (width=100, height=100).
Input should be less than or equal to 6: parameters.n
Model 'qwen-image-3.0-distill' supports 0~3 image content items. Got 4 image items. (0 images = T2I mode, 1~3 images = I2I mode)Perguntas frequentes
Por que o Qwen-Image retorna url em vez de b64_json?
O Qwen-Image retorna um link temporário de imagem do Alibaba Cloud OSS (data[].url), e não base64. O link expira após 24 horas; baixe e armazene a imagem logo depois de obtê-lo.
Como editar imagens com o Qwen-Image?
Envie input_images em /v1/images/generations (um array com 1 a 3 imagens, em que cada item é uma URL de imagem ou um base64 iniciado por data:image). image é um campo do Seedream e não é suportado pelo Qwen-Image; /v1/images/edits também não é suportado.
O Qwen-Image retorna Image area must be between 262144 and 6553600 pixels?
O total de pixels do tamanho precisa ficar entre 512x512 e 2560x2560. Por exemplo, 100x100 é pequeno demais e 3000x3000, grande demais. Use 1024x1024, 2048x2048, 2560x1440 ou similares.
Quantas imagens o Qwen-Image gera de uma vez, no máximo?
O máximo de n é 6; 7 ou mais retorna 400. Para mais imagens, divida em várias requisições.
O link da imagem do Qwen-Image não abre mais?
O parâmetro Expires do link corresponde a 24 horas após a geração; depois disso, não é possível baixar a imagem, e só resta gerá-la novamente. Depois de obter o link, baixe a imagem e salve-a no seu próprio armazenamento o quanto antes.