Introdução
O Qwen Image Edit Spicy edita uma única imagem de origem com uma única instrução em inglês simples. Não há máscara, seletor de área nem controle de quanto se afastar do original — a frase é todo o comando, e só fica protegido o que você nomear.
A requisição é image_url, prompt e um seed opcional; um seed igual a 0 pede um sorteio aleatório. Cada requisição devolve uma imagem.
Recursos e destaques
Sem máscara, sem intensidade, sem fluxo de inpainting
A maioria dos editores faz você escolher uma área e um grau de mudança antes de alterar qualquer coisa. Este recebe uma frase. Diga o que muda, diga o que precisa ficar e envie. A falta de um controle de intensidade é proposital: a preservação é expressa em palavras, e é assim também que você confere uma edição depois.
Trocas de figurino ousadas, sem filtro
Uma troca de figurino que editores com filtro recusam é aqui uma instrução comum, não um caso especial. Não há indicador de maturidade para ativar nem outro endpoint para onde a requisição seja desviada. A redação na instrução segue do jeito que foi escrita.
Reescreva uma placa sem redesenhar o cômodo
Como herda a tipografia da linha Qwen Image, ele consegue mudar um texto que já está na imagem — um aviso de porta, uma lousa de cardápio, o rótulo de uma garrafa. Cite o texto que está lá e o que você quer, e deixe claro que pose, enquadramento e tratamento de cor não mudam.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | Um link público e diretamente baixável de uma imagem cujos direitos você detém. pelo menos 1 caracteres |
prompt | Sim | Uma instrução carregando as duas metades da edição. pelo menos 1 caracteres |
seed | Não | Passe o mesmo seed com a mesma imagem e instrução para o sorteio ficar idêntico entre duas edições, com a única diferença sendo o que você mudou; é ferramenta de comparação, não… |
Preços
$0.038 / imagem
Casos de uso
Refinar uma imagem fornecida
Use este endpoint quando uma foto existente precisa continuar sendo aquela foto e só uma coisa deve mudar. Envie-a como image_url, diga a mudança e os elementos que precisam ficar — pose, enquadramento, luz, tratamento de cor — e compare o resultado com a origem.
Instruções que outros editores recusam
Instruções ousadas de figurino que as APIs de edição com filtro recusam rodam aqui como edições comuns. Nada muda na requisição: os mesmos nomes de campo, o mesmo ciclo de vida da tarefa, a mesma consulta assíncrona do resultado.
Trocas de figurino numa imagem aprovada
Você já tem um retrato em que a pose e a luz funcionam. Troque o figurino por roupa de noite ou um visual mais ousado sem regenerar a cena, para que o rosto, o cômodo e a gradação sobrevivam à mudança e o conjunto continue coerente.
Variações de texto numa foto que já custou dinheiro
Mude só as palavras de uma placa, de um aviso ou de um rótulo e mantenha a fotografia idêntica. Mais barato e muito mais consistente do que gerar a cena inteira de novo para cada idioma ou cada frase de campanha.
Guia de prompt e dicas práticas
Hospede a imagem de origem num lugar acessível
image_url precisa ser um link público de download direto — não uma página de visualização nem uma URL assinada que expira antes de a tarefa rodar. A origem define a composição e o teto de qualidade de toda a passada.
Escreva uma instrução que nomeie os dois lados da edição
Diga o que muda e o que precisa continuar idêntico, uma frase para cada. A edição deste endpoint saiu de: “Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.”
Adapte o exemplo incluído
Comece pelo exemplo publicado, com uma URL de acesso público em image_url. Troque o assunto e a direção criativa, mas mantenha o contrato de entrada deste modo.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
A instrução exata por trás da edição mostrada para este endpoint: uma troca de figurino mais uma troca de texto no cabide da porta, com pose, enquadramento, iluminação e gradação todos nomeados como inalterados. Forneça a sua própria imagem de origem — a image_url aqui é um marcador, não uma amostra hospedada.
Confira o resultado antes de iterar
O caminho confiável é uma mudança por chamada, nomeando de forma explícita o que se preserva — pose, enquadramento, luz, tratamento de cor. Peça uma troca de figurino e uma de texto na mesma instrução e uma delas costuma escapar. A identidade se mantém bem numa única edição pontual e se degrada em cadeias longas, então volte a editar a partir do original, e não do resultado anterior. Não há controle de intensidade: se uma edição foi longe demais, a solução é uma frase mais específica, não um número menor.
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-spicy-edit/edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
