Skip to main content
POST

Modelos suportados

Autorização

string
obrigatório
Todos os endpoints exigem autenticação por Bearer TokenObtenha sua chave de API:Acesse o gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:

Corpo da requisição

string
obrigatório
Nome do modelo
  • qwen-image-2.0 - Versão padrão, qualidade e desempenho equilibrados
  • qwen-image-2.0-pro - Versão Pro, renderização de texto mais forte, texturas realistas mais refinadas
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual para a geração da imagem, até 800 caracteres
string
padrão:"1:1"
Proporção da imagemProporções suportadas:
  • 1:1 - Quadrado (padrão)
  • 4:3 - Paisagem 4:3
  • 3:4 - Retrato 3:4
  • 16:9 - Paisagem widescreen
  • 9:16 - Retrato vertical
  • 3:2 - Paisagem 3:2
  • 2:3 - Retrato 2:3
string
padrão:"1K"
Nível de resolução
  • 1K - Resolução padrão (padrão)
  • 2K - Resolução de alta definição
integer
padrão:"1"
Número de imagens a serem geradasIntervalo: 1–6
string
Prompt negativo (conteúdo que você não quer que apareça), até 500 caracteres
array
Array de URLs de imagens de referência (modo image-to-image)Limitações:
  • Devem ser URLs publicamente acessíveis
  • O formato Base64 não é suportado

Tabela de referência de resoluções

O tamanho da saída é controlado pela combinação size (proporção) + resolution (nível de resolução).
  • Apenas size → padrão para o nível 1K: {"size": "16:9"} → 1280×720
  • size + resolution → nível especificado: {"size": "16:9", "resolution": "2K"} → 2048×1152

Exemplos de uso

Text-to-Image (requisição mínima)
Especificar proporção e quantidade
Nível 2K de alta definição
Image-to-Image (imagem de referência + descrição textual)

Resposta

integer
Código de status da resposta
array
Array de dados da resposta

Observações

  1. Processamento assíncrono: após o envio, um task_id é retornado. Consulte /v1/tasks/{task_id} para obter os resultados
  2. Armazenamento de imagens: as imagens geradas são espelhadas no CDN da plataforma e ficam válidas por longo prazo
  3. Regras de cobrança: cobrado por imagem gerada com sucesso, sem cobrança em caso de falha
  4. Requisitos para URLs de imagens: as imagens de entrada devem ser URLs publicamente acessíveis; base64 não é suportado