Introdução
O que este endpoint faz
O Qwen Image 2.1 Pro Texto para Imagem transforma um briefing escrito em uma a seis imagens por requisição, com o nível Pro hospedado do Qwen Image 2.1, da Alibaba. Nossas requisições levaram de 14 a 43 segundos de ponta a ponta.
Entradas
prompt leva o briefing inteiro, com até 5.000 caracteres. num_outputs pede de uma a seis imagens. aspect_ratio escolhe uma de quinze proporções e resolution o nível 1k, 1.5k ou 2k, todos com o mesmo preço por imagem. enable_prompt_expansion (desativado por padrão) deixa a Alibaba reescrever o prompt antes, com prompt_optimization_mode e enable_thinking moldando essa reescrita. seed estabiliza uma série.
Conteúdo
Sem filtro da plataforma. Com a expansão desativada, todos os testes de conteúdo que rodamos saíram como escritos.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Imagem |
| Status na SpicyAPI | No ar: texto para imagem e edição de imagens |
| Base | Qwen Image 2.1, como nível Pro hospedado da Alibaba |
| Imagens por requisição | 1 a 6, cobradas por imagem devolvida |
| Preço | Um preço fixo por imagem nos níveis 1k, 1.5k e 2k; a cotação ao vivo está nesta página |
| Proporções | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Tamanhos em 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Edição | 1 a 10 imagens de referência; sem proporção, a saída segue a origem em cerca de 2K |
| Prompt | Até 5.000 caracteres; sem prompt negativo, então escreva as exclusões no próprio prompt |
| Expansão de prompt | Desativada por padrão; reescrita direct ou agent quando ativada, com uma passagem opcional de raciocínio |
| Espera medida | De 14 a 43 segundos para texto para imagem, de 39 a 48 segundos para edições, nas nossas execuções |
| Política de conteúdo | Sem censura: sem filtro da plataforma, sem marcador de maioridade |
| Pesos | Não publicados; a Alibaba oferece o Pro como API hospedada |
Recursos e destaques
Um título escrito certo de primeira
Coloque as palavras entre aspas e diga onde elas ficam. "AFTER DARK" no alto e a pequena chamada de capa logo abaixo voltaram letra por letra, nas duas imagens da requisição.
Dois retratos, uma mesa à luz de velas
Um homem e uma mulher fotografados separadamente, chamados de Image 1 e Image 2, acabam em uma mesma mesa em um terraço de vinhedo, com os dois rostos ainda reconhecíveis e o vestido dela trocado como pedido.
Pro ou Turbo, sem reescrever uma linha
O Pro e o Turbo leem os mesmos campos na SpicyAPI, então um prompt que funciona em um pode ser enviado ao outro sem mudanças. Faça rascunhos rápidos no Turbo e fique com os quadros que importam no Pro, ou o contrário.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | O briefing inteiro, com até 5.000 caracteres. Escreva sujeito, figurino, pose, luz e lente em frases simples. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Quinze formatos, de faixas 3:1 e 21:9 a colunas 1:3 e 9:21. O quadro é composto nesse formato, não recortado de um quadrado. |
resolution | Não | 1k, 1.5k ou 2k. Todos os níveis custam o mesmo por imagem, então 2k é o padrão. |
num_outputs | Não | De uma a seis imagens do mesmo prompt em uma requisição. Cada imagem devolvida é cobrada, então seis imagens custam seis vezes uma. |
enable_prompt_expansion | Não | Desligada por padrão, então sua redação é desenhada exatamente como escrita. Valor padrão: |
enable_thinking | Não | Gasta raciocínio extra na reescrita para uma imagem melhor, ao custo de uma espera maior. Só funciona enquanto a expansão de prompt está ativada. Valor padrão: |
prompt_optimization_mode | Não | Como a expansão reescreve o briefing quando está ativada: direct é uma única passagem que serve para a maioria dos prompts; agent é uma reescrita em várias etapas, com mais deta… |
seed | Não | Estabiliza um sorteio para que você mude uma coisa por vez e compare de forma justa. Não garante uma imagem idêntica pixel a pixel. |
Preços
$0.036 / imagem
Casos de uso
Trabalho de imagem sem censura
A SpicyAPI não coloca filtro de conteúdo na frente do Pro. Com a expansão de prompt desligada, nossos testes voltaram exatamente como escritos em todos os níveis de intensidade que rodamos, do Leve ao Máximo, com sujeitos femininos e masculinos.
Capas e pôsteres com texto exato
A Alibaba cita tipografia melhorada no Pro. Coloque entre aspas o título e a chamada da capa, diga onde cada um fica e descreva a fotografia: nossa capa de revista voltou com as duas linhas escritas exatamente, nas duas imagens da requisição.
Um personagem em toda uma série
Gere um personagem, depois envie o quadro de volta como referência e mude a roupa, o cômodo ou a luz em passagens separadas. Cada edição parte do quadro aprovado em vez de um novo sorteio, então o rosto se mantém ao longo da série.
Casais a partir de dois retratos
Envie dois retratos como Image 1 e Image 2 e descreva a cena que os dois dividem. No nosso teste, um homem e uma mulher fotografados separadamente acabaram em uma mesma mesa à luz de velas em um terraço de vinhedo, os dois ainda reconhecíveis.
Retratos intimistas e iluminação
A Alibaba aponta a iluminação de retrato e o detalhe fino como pontos fortes do Pro. Nomeie uma fonte de luz e onde ela cai, uma lamparina de tempestade, uma janela alta, uma arandela, e o quadro se constrói em torno dela.
Muitos rascunhos até achar o ideal
Até seis imagens por chamada a um preço fixo formam um leque barato de opções. Explore figurino, pose e luz em uma só requisição, fique com o quadro que funciona e gaste as suas edições nele.
Guia de prompt e dicas práticas
Deixe a expansão de prompt desativada quando a redação importar
A expansão entrega o seu prompt ao reescritor da Alibaba antes de a imagem ser desenhada, e essa reescrita pode amenizar um pedido ousado. Aqui ela vem desligada por padrão, e todos os testes de conteúdo que fizemos com ela desligada voltaram exatamente como escritos. Na nossa única execução Pro com ela ligada, um prompt que o app oficial bloquearia passou, mas mantenha-a desligada sempre que a redação exata importar.
Ative para prompts curtos do dia a dia
Um briefing de seis palavras ganha uma cena mais completa com a expansão ativada. direct reescreve em uma passagem e serve para a maioria dos prompts; agent reescreve em várias etapas para um resultado mais fino. O modo de raciocínio gasta raciocínio extra nessa reescrita e acrescenta tempo; ele não faz nada enquanto a expansão está desativada.
Use 2K, custa o mesmo
Todos os níveis têm o mesmo preço por imagem, então 2K é o padrão e a escolha sensata. Desça para 1k só quando quiser um arquivo menor ou um retorno um pouco mais rápido.
Peça várias imagens de uma vez
Defina
num_outputsde 1 a 6 para obter variações de um mesmo prompt em uma chamada. Cada imagem devolvida é cobrada, então seis imagens custam seis vezes uma. É o jeito mais barato de achar a pose ou a composição de que você gosta antes de começar a editar.Na edição, escreva primeiro a mudança e depois a lista do que fica
Escreva primeiro a única coisa que muda e depois tudo o que precisa permanecer: "Troque o vestido de veludo dela por um vestido de noite marfim; mantenha o rosto, o cabelo e a expressão." Nomeie as referências pelo número. No nosso teste com dois retratos, "o homem da imagem 1 e a mulher da imagem 2" numa mesa à luz de velas manteve os dois rostos reconhecíveis num mesmo quadro.
Coloque entre aspas as palavras que devem aparecer
Coloque a redação exata entre aspas e diga onde ela fica. Nossa capa de revista, com "AFTER DARK" no alto e "THE SILK ISSUE · NO. 07" em letras pequenas abaixo, voltou letra por letra. Mantenha cada linha curta e confira em tamanho real antes de publicar.
Escreva o prompt em uma ordem fixa
Sujeito, figurino, pose, luz, lente e paleta, em frases simples. Nomeie a fonte de luz e a direção dela (uma lamparina a óleo à esquerda, um feixe giratório atrás dela) em vez de uma palavra de clima. Com a expansão desativada, o Pro desenha o que você escreve e não preenche as lacunas por você.
Introdução
O Qwen Image 2.1 Pro Texto para Imagem transforma um briefing escrito em imagens. O Pro é o nível hospedado do Qwen Image 2.1, da Alibaba, que a empresa anunciou como oficialmente no ar junto com a API do Turbo em 9 de outubro de 2026 e descreve como um equilíbrio entre qualidade de geração, eficiência de inferência e custo, com tipografia, iluminação de retrato e detalhe fino melhorados. A Alibaba o oferece como API e não publicou pesos para ele.
Na SpicyAPI ele está no ar. Uma requisição devolve de uma a seis imagens, os níveis 1k, 1.5k e 2k custam o mesmo por imagem e não há filtro de conteúdo na frente do modelo. Todas as imagens desta página foram geradas no Pro com o prompt mostrado.
Escolha um modo conforme o que você tem
| Material de partida | Modo |
|---|---|
| Um briefing escrito e mais nada | Qwen Image 2.1 Pro Texto para imagem |
| Uma ou mais imagens para alterar | Qwen Image 2.1 Pro Edição de imagens |
O que medimos
Velocidade
De 14 a 31 segundos para uma única imagem e de 39 a 43 segundos para duas imagens 2K em uma chamada, de ponta a ponta, nas nossas execuções. A expansão de prompt e o modo de raciocínio acrescentam tempo quando estão ativados.
Conteúdo
Com a expansão de prompt desligada, o padrão, todos os testes de conteúdo voltaram exatamente como escritos, do Leve ao nível Máximo, com um sujeito feminino e um masculino. Nenhuma requisição foi recusada. Na nossa única execução com a expansão ligada, um prompt sem filtro também voltou como pedido.
Texto na imagem
Nossa capa de revista pediu "AFTER DARK" como título e "THE SILK ISSUE · NO. 07" abaixo dele e recebeu as duas linhas, letra por letra, nas duas imagens da requisição.
Tamanhos em 2K
| Proporção | Tamanho de saída |
|---|---|
| 1:1 | 2048 × 2048 |
| 16:9 | 2688 × 1536 |
| 9:16 | 1536 × 2688 |
| 4:3 | 2368 × 1760 |
| 3:2 | 2496 × 1664 |
| 2:3 | 1664 × 2496 |
São quinze proporções ao todo, de 3:1 a 1:3, em 1k, 1.5k e 2k. A saída é PNG.
Pro ou Turbo
| Pro | Turbo | |
|---|---|---|
| O que é | Nível Pro hospedado da Alibaba | Checkpoint de 8 passos |
| Pesos | Não publicados | Abertos, Qwen Research License |
| Imagens por requisição | 1 a 6 | 1 a 6 |
| Preço por nível | Fixo | Fixo |
| Preço por imagem | Maior | Menor |
| Filtro de conteúdo | Nenhum | Nenhum |
A requisição é a mesma, então você pode enviar um prompt aos dois e ficar com o resultado de que mais gostar. A Alibaba não publicou uma comparação de qualidade entre eles.
Guia de prompts e dicas profissionais
Mantenha a expansão desativada para uma redação exata
A reescrita pode amenizar um pedido ousado. Desligada, o Pro desenha o que você escreve.
Ative a expansão para prompts curtos do dia a dia
Uma ideia de seis palavras ganha uma cena mais completa. direct serve para a maioria dos prompts, agent reescreve com mais detalhe e o modo de raciocínio gasta tempo extra para uma reescrita melhor.
Escreva em uma ordem fixa
Sujeito, figurino, pose, luz, lente e paleta, em frases simples. Nomeie a fonte de luz e a direção dela em vez de uma palavra de clima.
Coloque entre aspas as palavras que devem aparecer
Coloque a redação exata entre aspas, mantenha cada linha curta e diga onde ela fica.
Peça seis, fique com uma
Cada variação custa o mesmo, então uma requisição de seis imagens é o jeito mais rápido de achar a pose ou a composição que vale a pena editar.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2.1-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
