Introdução
O que este endpoint faz
O Qwen Image 2.1 Pro Edição de Imagens revisa as suas imagens de origem a partir de uma instrução escrita e devolve de um a seis quadros novos, com o nível Pro hospedado do Qwen Image 2.1, da Alibaba. Nossas edições levaram de 39 a 48 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 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 desligada, cada edição testada voltou como pedido, nos cinco níveis de intensidade, do Leve ao Máximo.
| 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 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 | A instrução de edição, com até 5.000 caracteres. Diga primeiro o que muda e depois o que precisa 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 muda 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 só 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 | Desligada por padrão, então sua instrução chega ao modelo exatamente como escrita. Ligada, a Alibaba a reescreve primeiro, o que pode amenizar um pedido mais ousado. 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 que você compare uma mudança por vez. 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 Edição de Imagens altera uma imagem existente a partir de uma instrução em linguagem simples. O Pro é o nível hospedado do Qwen Image 2.1, da Alibaba, que unifica geração e edição em um só modelo; a Alibaba lista edição com até dez referências, edições locais que preservam pessoas e produtos, e iluminação de retrato e detalhe fino melhorados.
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 Pro 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 Pro Edição de imagens |
| Um briefing escrito e mais nada | Qwen Image 2.1 Pro Texto para imagem |
O que medimos
Velocidade
De 39 a 48 segundos por edição, de ponta a ponta, nas nossas execuções, incluindo dois resultados a partir de duas referências em uma chamada.
Formato
Sem proporção definida, um retrato 2:3 voltou como um quadro 2:3 em cerca de 2K (1664 × 2496). Defina uma proporção quando precisar de um tamanho fixo.
Conteúdo
Com a expansão de prompt desligada, o padrão, cada edição testada voltou como pedido, nos cinco níveis de intensidade, do Leve ao Máximo. Nenhuma edição foi recusada.
Duas referências
Um homem e uma mulher fotografados separadamente voltaram lado a lado em uma mesma mesa à luz de velas, os dois reconhecíveis, com a roupa dela trocada como pedido.
Edição do Pro ou do Turbo
| Pro | Turbo | |
|---|---|---|
| O que é | Nível Pro hospedado da Alibaba | Checkpoint de 8 passos |
| Pesos | Não publicados | Abertos, Qwen Research License |
| Resultados por requisição | 1 a 6 | 1 a 6 |
| Preço por referência extra | Nenhum | Nenhum |
| Preço por imagem | Maior | Menor |
| Filtro de conteúdo | Nenhum | Nenhum |
A requisição é a mesma, então você pode rodar uma instrução nos dois e ficar com o resultado de que mais gostar.
Guia de prompts e dicas profissionais
Primeiro a mudança, depois o que fica
"Troque o vestido de veludo dela por um vestido de noite marfim; mantenha o rosto, o cabelo e a expressão" é uma edição. "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 suavizar a sua instrução antes de o modelo vê-la. 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-pro/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.
