Qwen Image 3.0
Geração de imagens Qwen Image 3.0
- Modo de processamento assíncrono, retorna um ID de tarefa para consultas posteriores
- Suporta texto-para-imagem e imagem-para-imagem (1-3 imagens de referência para edição)
- Suporta resolução 1K / 2K, até 6 imagens por requisição
- Variantes Standard e Pro (Pro é mais forte para layout denso e texto)
POST
Modelos suportados
Autorização
string
obrigatório
Todos os endpoints exigem autenticação por Bearer TokenObtenha sua chave de API na página de gerenciamento de chaves de API:
Body
string
obrigatório
Nome do modelo
qwen-image-3.0- Standardqwen-image-3.0-pro- Pro (texto / layout denso)
string
obrigatório
Descrição textual para a geração de imagens, máx. ~4.5k tokens
string[]
Array de URLs de imagens de referência (imagem-para-imagem / edição), 1-3 imagens
- URL pública
http(s)://oudata:image/png;base64,...(base64 é reenviado primeiro) - Formatos: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
- Por arquivo ≤ 10MB; largura/altura recomendadas 384-2048 px
string
padrão:"1K"
Nível de resolução (afeta o nível de cobrança)
1K(padrão; minúsculas aceitas)2K
size (ex. 1600x900). Com pixels brutos, área > 2,25M pixels é cobrada como 2K.string
padrão:"1:1"
Proporção, ou tamanho em pixels explícitoProporções suportadas:
1:1(padrão)4:3/3:416:9/9:163:2/2:3
16x9, ou pixels como 1024x1024. Para pixels personalizados, cada lado (largura e altura) deve ser 512–2048, proporção 1:8 ~ 8:1.Se nem size nem resolution forem definidos, a saída fica fixa em 1024×1024.integer
padrão:"1"
Número de imagens, 1-6. Valores acima de 6 são limitados a 6.
string
Prompt negativo: conteúdo a evitar
boolean
padrão:"false"
Reescrita inteligente do promptDesativado por padrão para resultados previsíveis. Defina
true para ativar a reescrita inteligente.string
Modo de reescrita (apenas série 3.0; requer
prompt_extend: true)direct- funciona para texto-para-imagem e imagem-para-imagemagent- apenas texto-para-imagem, reescrita mais agressiva
Tabela de referência de tamanhos
Combineresolution (nível) + size (proporção):
Casos de uso
Texto-para-imagem (múltiplas)
Layout denso com reescrita
Imagem-para-imagem (edição)
Prompt negativo
Limites
Response
integer
Código de status; 200 em caso de sucesso
array
Array de dados da resposta
Diferenças em relação à 2.0
Observações
- Assíncrono: o envio retorna um
task_id. Consulte Obter status da tarefa a cada 3~5 segundos; timeout do cliente ~3 minutos (2K + multi-imagem é mais lento). - Armazenamento: as imagens são espelhadas no CDN da plataforma para acesso de longo prazo.
- Cobrança: por imagem entregue × nível de resolução pela área real em pixels (> 2,25M pixels = 2K).
qwen-image-3.0cobra o mesmo para 1K/2K;-pro2K é 2× 1K. Falhas são totalmente reembolsadas; imagens de referência são gratuitas. - Erros: tamanho/proporção inválidos,
agentem imagem-para-imagem, referências inacessíveis/grandes demais → 400; limite de taxa → 429.
Consultar resultadosUse Obter status da tarefa para o progresso e
result.images.