Introdução
O que este endpoint faz
O Qwen Image 2.1 Turbo Edição de imagens revisa as suas imagens de origem conforme uma instrução escrita e devolve de um a seis quadros novos, com o checkpoint de 8 passos do Qwen Image 2.1 da Alibaba. Nossas edições levaram de 26 a 59 segundos de ponta a ponta.
Entradas
image_urls leva de uma a dez referências, na ordem em que você as chama de Image 1, Image 2 e assim por diante. prompt é a instrução. Deixe aspect_ratio de fora para manter o formato da origem em cerca de 2K, ou defina-o junto com resolution para um tamanho fixo. num_outputs pede de um a seis resultados, enable_prompt_expansion (desativada por padrão) e enable_thinking controlam a reescrita da Alibaba, e seed estabiliza uma série.
Conteúdo
Sem filtro da plataforma. Com a expansão desativada, edições que trocam roupas ou revelam mais saíram como pedido; com ela ativada, a mesma instrução voltou sem mudanças.
| Campo | Valor |
|---|---|
| Entrada | Imagem |
| Saída | Imagem |
| Status na SpicyAPI | No ar: texto para imagem e edição de imagens |
| Base | Qwen Image 2.1, como um checkpoint acelerado de 8 passos do mesmo modelo de 7B |
| Imagens por requisição | De 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 em tempo real 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 | De 1 a 10 imagens de referência; sem proporção, a saída segue a imagem de 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 etapa opcional de raciocínio |
| Espera medida | De 13 a 39 segundos para texto para imagem, de 26 a 59 segundos para edições, nas nossas execuções |
| Política de conteúdo | Sem censura: sem filtro da plataforma, sem flag de maturidade |
| Pesos abertos | Qwen/Qwen-Image-2.1-Turbo, sob a Qwen Research License Agreement |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | A instrução de edição, com até 5.000 caracteres. Diga primeiro o que muda e depois o que deve ficar: rosto, cabelo, pose, luz. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De uma a dez imagens de origem, na ordem em que você se refere a elas. O número de referências não altera o preço. pelo menos 1 itens · no máximo 10 itens |
aspect_ratio | Não | Deixe de fora e o resultado mantém o formato da sua origem em cerca de 2K. |
resolution | Não | 1k, 1.5k ou 2k, usado apenas quando você define uma proporção. Todos os níveis custam o mesmo por imagem. |
num_outputs | Não | De um a seis resultados da mesma instrução em uma requisição. Cada imagem devolvida é cobrada. |
enable_prompt_expansion | Não | Desativada por padrão. Valor padrão: |
enable_thinking | Não | Gasta raciocínio extra na reescrita, ao custo de uma espera maior. Só funciona enquanto a expansão de prompt está ativada. Valor padrão: |
seed | Não | Estabiliza um sorteio para você comparar uma mudança por vez. Não garante uma imagem idêntica pixel a pixel. |
Preços
$0.014 / imagem
Casos de uso
Trabalho de imagem sem censura
A SpicyAPI não coloca nenhum filtro de conteúdo na frente do Turbo. Com a expansão de prompt desligada, nossos testes saíram como escritos em cada nível de conteúdo que executamos, de Leve a Máximo, para mulheres e homens igualmente. No nível Muito forte, uma de duas execuções passou; a outra parou antes de concluir a solicitação.
Muitos rascunhos até achar o ideal
Oito passos e até seis imagens por chamada dão um leque barato de opções. Explore figurino, pose e luz em uma única requisição, fique com o quadro que funciona e gaste suas edições nele.
Um personagem em toda uma série
Gere um personagem, envie o quadro de volta como referência e mude o vestido, o ambiente ou a luz em passagens separadas. Cada edição parte do seu quadro aprovado, e não 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 eles dividem. No nosso teste, um homem e uma mulher fotografados separadamente acabaram rindo lado a lado em um terraço ao entardecer, os dois ainda reconhecíveis.
Pôsteres e tipografia
O Turbo compõe manchetes curtas com limpeza. Coloque a redação entre aspas, diga onde ela fica e descreva o estilo do pôster: nosso pôster de cabaré saiu com as duas linhas escritas exatamente.
Fotos de produto e capas
Preço fixo até 2K e seis imagens por chamada combinam com miniaturas, capas e fotos de produto, em que você quer vários recortes de uma mesma ideia e um master em tamanho real para reduzir depois.
Guia de prompt e dicas práticas
Deixe a expansão de prompt desativada em trabalhos adultos
A expansão envia seu prompt ao reescritor da Alibaba antes de a imagem ser desenhada, e o reescritor suaviza os briefs sem filtro: em nossos testes, ele amenizou uma imagem de nível Forte, transformou uma cena de nível Muito forte em uma que apenas sugeria, e devolveu uma edição que pedia para ir além sem mudar nada. Com a expansão desativada, os mesmos prompts saíram como escritos. Ela vem desativada por padrão aqui; mantenha assim, a menos que você queira a reescrita.
Ative para prompts curtos do dia a dia
Um briefing de seis palavras ganha uma cena mais completa quando a expansão está ativada. direct reescreve em uma única passagem e serve para a maioria dos prompts; agent reescreve em várias etapas para um resultado mais refinado. O modo de raciocínio gasta raciocínio extra nessa reescrita e acrescenta tempo; 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 receber variações de um mesmo prompt em uma única chamada. Cada imagem devolvida é cobrada, então seis imagens custam seis vezes o valor de uma. É a forma mais barata de encontrar uma pose ou uma composição de que você goste antes de começar a editar.Na edição, escreva primeiro a mudança e depois a lista do que fica
Escreva a única coisa que muda e, em seguida, tudo o que precisa ficar: "Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression." (troque o vestido de veludo escuro dela por um vestido de cetim carmesim de costas abertas; mantenha o rosto, o cabelo e a expressão). Indique as referências pelo número. No nosso teste com dois retratos, "the man from Image 1 and the woman from Image 2" manteve os dois rostos reconhecíveis no mesmo quadro.
Coloque entre aspas as palavras que devem aparecer
Coloque a redação exata entre aspas e diga onde ela vai. No nosso teste de pôster, "VELVET HOUR" no alto e "LATE SHOW · FRIDAYS 11 PM" embaixo saíram 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 (um abajur quente à esquerda, vidro riscado de chuva atrás dela) em vez de uma palavra de clima. Com a expansão desativada, o Turbo desenha o que você escreve e não preenche as lacunas por você.
Introdução
O Qwen Image 2.1 Turbo Edição de imagens altera uma imagem existente a partir de uma instrução em linguagem simples. A equipe Qwen da Alibaba lançou o Turbo com pesos abertos em 9 de outubro de 2026 e o construiu para a criação contínua por meio de edições em linguagem natural, de adicionar um acessório a trocar a cena, em 8 passos de denoising, na mesma arquitetura de 7B do Qwen Image 2.1.
Na SpicyAPI ele está no ar. Uma requisição aceita de uma a dez referências e devolve de um a seis resultados a um preço fixo por imagem, sem filtro de conteúdo na frente do modelo. Todos os exemplos desta página foram gerados no Turbo com o prompt mostrado.
Escolha um modo conforme o que você tem
| Material de partida | Modo |
|---|---|
| Uma ou mais imagens para alterar | Qwen Image 2.1 Turbo Edição de imagens |
| Um briefing escrito e mais nada | Qwen Image 2.1 Turbo Texto para imagem |
O que medimos
Velocidade
De 26 a 59 segundos por edição, de ponta a ponta, nas nossas execuções.
Formato
Sem proporção definida, um retrato 2:3 voltou como um quadro 2:3 em cerca de 2K (1680 × 2512). Defina uma proporção quando precisar de um tamanho fixo.
Conteúdo
Com a expansão de prompt desligada, o padrão, as edições em todos os níveis de conteúdo que testamos voltaram como pedido, em um retrato de mulher e um de homem. Com a expansão ligada, o pedido para ir além voltou duas vezes como a fonte intocada e foi cobrado como concluído.
Duas referências
Um homem e uma mulher fotografados separadamente voltaram lado a lado no mesmo terraço, os dois reconhecíveis, com a roupa dela trocada como pedido.
Edição do Turbo ou do Qwen Image 2.1
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| Passos de denoising | 8 | 40 |
| Resultados por requisição | 1 a 6 | 1 |
| Preço por referência extra | Nenhum | Cada uma soma ao preço |
| Máscara para edições locais | Não | Sim |
| Formato de saída | PNG | JPEG, PNG ou WebP |
| Filtro de conteúdo | Nenhum | Nenhum |
Escolha o Turbo para cadeias rápidas de edições e trabalho com várias referências a preço fixo. Escolha o Qwen Image 2.1 quando precisar de uma máscara.
Guia de prompts e dicas profissionais
Primeiro a mudança, depois o que fica
"Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression" (troque o vestido de veludo escuro dela por um vestido de cetim carmesim de costas abertas; mantenha o rosto, o cabelo e a expressão) é uma edição. "Make it better" (deixe melhor) é um novo sorteio.
Nomeie cada referência
O modelo não atribui papéis às referências por conta própria. Diga qual imagem é a pessoa, qual é a peça de roupa e qual é o lugar.
Deixe a expansão desativada
A reescrita pode descartar a sua instrução e devolver a imagem de origem. Desativada, a instrução chega ao modelo como escrita.
Uma mudança por passagem
Uma única mudança é fácil de avaliar. Cinco de uma vez dificultam saber qual instrução moveu o rosto ou as mãos.
Volte ao original depois de algumas edições
Os rostos podem desviar ao longo de uma cadeia longa de edições. Volte ao seu primeiro quadro aprovado quando os detalhes começarem a se mover.
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-turbo/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.
