Skip to main content
POST

Modelos suportados

Prefira -pro para texto/layout denso. Use qwen-image-3.0 para imagens gerais. Prompt máx. ~4.5k tokens. Os nomes dos modelos não são intercambiáveis com a série 2.0.

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 - Standard
  • qwen-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):// ou data: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
Você pode omitir o nível e passar pixels em 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:4
  • 16:9 / 9:16
  • 3:2 / 2:3
Também aceita o estilo 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-imagem
  • agent - apenas texto-para-imagem, reescrita mais agressiva
Valores inválidos são ignorados.

Tabela de referência de tamanhos

Combine resolution (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

  1. 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).
  2. Armazenamento: as imagens são espelhadas no CDN da plataforma para acesso de longo prazo.
  3. Cobrança: por imagem entregue × nível de resolução pela área real em pixels (> 2,25M pixels = 2K). qwen-image-3.0 cobra o mesmo para 1K/2K; -pro 2K é 2× 1K. Falhas são totalmente reembolsadas; imagens de referência são gratuitas.
  4. Erros: tamanho/proporção inválidos, agent em 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.