Como Usar a API Qwen Image 2.1

Qwen Image 2.1 está disponível no EmpirioLabs. É o modelo de geração e edição de imagens da Alibaba, servido como um único ID de modelo com duas variantes: Pro para a maior qualidade de imagem e edições complexas, e Turbo para geração mais rápida e de menor custo. Ambos funcionam até PÓS-/v1/images/generations, na API e na Playground.

Assista ao filme de lançamento

Cada imagem do filme é uma saída real da Qwen Image 2.1. A trilha foi gerada pela ACE-Step no EmpirioLabs. Assista no YouTube.

Pro ou Turbo?

Pro é o padrão. Ambas as variantes aceitam até dez imagens de referência e retornam até seis imagens por requisição. Escolha uma variante com model_variant; os IDs dos modelos qwen-image-2.1-pro e qwen-image-2.1-turbo Também selecione um direto.

Gerar uma imagem

Definir sincronização: verdadeiro para receber a imagem finalizada na resposta. Sem ela, a solicitação retorna uma tarefa para consultar VÁ /v1/jobs/{id}.

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Conteúdo: application/json" \ -d '{ "modelo": "qwen-image-2-1", "model_variant": "qwen-image-2.1-turbo", "prompt": "Um mercado noturno na chuva, lanternas de papel refletidas em poças, uma placa pintada à mão que diz ABERTO TARDE", "resolução": "1K", "aspect_ratio": "16:9", "num_images": 2, "sync": verdadeiro }'

Editar com imagens de referência

Anexe de uma a dez imagens em Imagens, e o prompt torna-se a instrução de edição:

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Conteúdo: application/json" \ -d '{ "modelo": "qwen-image-2-1", "imagens": [ "https://example.com/product.png", "https://example.com/kitchen.png" ], "prompt": "Coloque a garrafa da primeira imagem no balcão de mármore da segunda imagem, sob luz suave da manhã.", "tamanho": "2048*1536", "negative_prompt": "rótulo distorcido, garrafa duplicada", "semente": 4242, "sincronização": verdadeira }'

Imagens transparentes

Saída PNG transparente. As saídas são arquivos PNG. Para um fundo transparente, defina prompt_extend para falso e descreva a imagem desta forma:

{ "modelo": "qwen-image-2-1", "prompt": "Esta é uma imagem RGBA com transparência. Uma caneca de café cerâmica com um esmalte azul. A imagem tem canal alfa e o fundo é transparente.", "prompt_extend": falso, "resolução": "1K", "aspect_ratio": "1:1", "sincronização": verdadeiro }

Tamanhos

• Presets. Definir resolução para 1K, 2K, ou Auto, e aspect_ratio para Auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, ou 4:5. Os valores padrão, 2K e auto, retornam uma imagem 2048x2048.
• Tamanhos exatos. Enviar Tamanho como LARGURA*ALTURA, ou conjunto use_custom_size com custom_width e custom_height. A área total deve permanecer entre 512x512 e 2560x2560 pixels, com uma proporção de aspecto de 1:8 a 8:1.
• Longas bandeiras. O limite é na área, então um lado pode exceder 2560 pixels: 4096*512 é um tamanho válido.

Notas operacionais

• A extensão do prompt do agente é apenas para text-to-image. Um pedido que anexa imagens com prompt_extend_mode definir para agente falha. Use Direto, o padrão, quando você edita.
• Resolução automática com proporção fixa usa o predefinido 1K. Resolução: "Auto" com aspect_ratio: "16:9" retornos 1920x1080. Cenário resolução para 2K para o tamanho maior.

Preços

Cada imagem de saída é cobrada na taxa de sua variante, que é a mesma em todos os tamanhos. Turbo é a variante de menor custo, e imagens de referência não adicionam custo. Veja ao vivo página do modelo e página de preços Para as taxas atuais.

Templates e Compor

Qwen Image 2.1 também está disponível no Modelos de geração e como modelo de imagem no Compose.

Comece a construir

Tente a imagem Qwen 2.1 no Área de reprodução, e leia o Documentação da API para cada parâmetro e campo de resposta.

Divulgação: Este artigo foi escrito com assistência de IA e revisado por EmpirioLabs IA.