Gerador de IA de imagem para imagem sem censura: guia prático da API de edição

Você quer mudar uma única coisa em uma foto por código: a luz, o fundo, a roupa ou uma linha de texto. Precisa de um editor que não recuse nem suavize a instrução silenciosamente. Este guia explica qual endpoint de edição chamar, quanto custa, o que aceita, como testar no Playground e depois por código ou com um Agent, e o que fazer se falhar.

Resumindo: uma chamada de imagem para imagem é uma tarefa em um endpoint cujo ID de modelo termina em /edit: você envia um prompt e uma imagem de origem e recebe o arquivo editado. Para uma foto e uma instrução, comece com Qwen Image Edit Spicy: $0,038 por edição, uma origem, sem máscara nem controle de intensidade. Para várias origens, use Qwen Image 3.0, Seedream 5.0 Pro ou Wan 2.7. Para uma máscara, use Qwen Image 2.1 ou FLUX.1 Dev LoRA; strength só existe em FLUX.1 Dev LoRA e Z-Image Turbo LoRA.

Os preços e limites abaixo vêm do catálogo atual e da documentação; cada preço foi obtido por meio de uma cotação gratuita.

O que “sem censura” significa em um endpoint de edição

“Sem censura” é a classificação do catálogo para um modelo que declara não ter filtro de conteúdo: SpicyAPI não adiciona uma varredura de conteúdo da plataforma e o modelo decide o que retorna. Isso não promete executar toda instrução. Planeje para dois resultados:

• Uma recusa encerra a tarefa como failed com errorCode: "content_rejected". A reserva no seu saldo é liberada integralmente.
• Um resultado suavizado é uma imagem pronta mais moderada do que você pediu. A tarefa teve sucesso e é cobrada; nada na resposta sinaliza isso. Só é possível perceber olhando a imagem.

Alguns limites valem para todos os modelos: nenhuma representação sexualizada de menores em qualquer estilo, nenhuma representação íntima ou sexualizada de pessoa real identificável sem consentimento documentado (incluindo troca de rosto e transferência de aparência), nenhuma personificação enganosa e nada ilegal onde você opera. É fácil violar a segunda regra em endpoints de edição, pois a origem costuma ser uma foto real. Segundo a política de uso aceitável, uma fotografia pública, a fama ou um relacionamento anterior não constituem consentimento; material de idade ambígua está sujeito à regra sobre menores e você não deve enviar material privado que não tem direito de processar.

SpicyAPI não revisa cada solicitação. Se seus usuários enviam fotos, as obrigações são suas: verificação de idade, declaração de consentimento no envio armazenada com o ID da tarefa, recusa de origens com idade incerta, bloqueio de edições de pessoas reais identificáveis sem consentimento documentado e um canal para denunciar conteúdo. Isto não é aconselhamento jurídico.

O serviço não está disponível na China continental, Rússia, Belarus, Cuba, Irã, Coreia do Norte ou Síria, nem, segundo os termos, no Reino Unido, Hong Kong, Macau, Arábia Saudita, Emirados Árabes Unidos, Catar, Kuwait, Bahrein, Omã, Paquistão, Bangladesh, Afeganistão, Indonésia, Malásia ou Brunei. A política de conteúdo e uso informa que a lista pode aumentar. Trocas de rosto e cabeça são endpoints separados com seu próprio fluxo, descrito no workflow da API de troca de rosto com IA.

Escolha o endpoint de edição

Os endpoints variam em número de origens, controles extras e formato do resultado:

Os preços são valores cotados para uma solicitação de uma imagem. Seedream 5.0 Pro custa o dobro no nível padrão 2k em comparação com 1k; Qwen Image 3.0 adiciona cobrança por origem. Os níveis de Qwen Image 2.1 não sobem em ordem (1,5k tem cotação maior que 2k e 2k é fixo independentemente das origens). Portanto, cote o corpo exato antes de planejar o orçamento.

O catálogo tem outros editores classificados sem censura, como Seedream 5.0 Flash, Qwen Image 3.0 Pro e Wan 2.7 Pro. Os endpoints de edição de GPT Image 2 e 2.5 e Nano Banana têm a classificação Filtered, então não são a ferramenta certa quando o objetivo é um resultado sem censura.

Uma foto, uma mudança. Use Qwen Image Edit Spicy. A solicitação inteira é image_url, prompt e um seed opcional; a instrução é o único controle, então uma frase que diz o que deve permanecer também é sua configuração de preservação. A avaliação aponta cerca de 21 segundos para uma edição típica. Qwen Image 2 segue a mesma ideia a um preço um pouco menor, com uma origem e prompt de até 800 caracteres.

Várias origens em uma edição. Um rosto de uma foto, uma peça de roupa de outra, um cômodo de uma terceira: Qwen Image 3.0 (três origens), Seedream 5.0 Pro (dez) ou Wan 2.7 (nove). O prompt deve dizer qual imagem fornece cada elemento. Seedream 5.0 Pro fica por padrão mais próximo do formato da primeira origem, Wan 2.7 da última e Qwen usa um quadrado: um retrato enviado a Qwen Image 3.0 sem aspect_ratio volta em 1:1.

Edições locais com máscara ou controle de intensidade. Qwen Image 2.1 e FLUX.1 Dev LoRA recebem uma máscara em mask_url: uma imagem em preto e branco do tamanho da origem, onde o branco é redesenhado e o preto preservado. strength (0 a 1, padrão 0,8, quanto o resultado se afasta da origem) existe em FLUX.1 Dev LoRA e no endpoint de edição Z-Image Turbo LoRA. Wan 2.7 marca regiões de outra forma, com até dois retângulos em pixels por imagem em bounding_boxes.

Resultados de conteúdo. Nos nossos relatórios públicos de setembro de 2026, cada editor passou por cinco níveis de conteúdo (L1 o mais moderado, L5 o mais intenso), geralmente com três execuções por nível.

FLUX.1 Dev LoRA é a opção mais barata com máscara e strength, mas seu relatório público cobre texto para imagem, em que os níveis mais fortes foram suavizados. Teste seu próprio nível de conteúdo em uma edição antes de se comprometer.

Os detalhes por modelo estão nas avaliações, como Seedream 5.0 Pro; o teste sem censura de Qwen Image Edit mostra pares de antes e depois dos editores Qwen.

Local ou hospedado? Com uma GPU de pelo menos 8 GB de VRAM e edições em volume, executar um modelo local no ComfyUI (Qwen Image Edit ou FLUX.2 Klein) é uma opção real. Hospedagem faz sentido se você não quer administrar uma GPU, precisa chamar o editor de um app ou prefere pagar por imagem: a $0,018–$0,072 por imagem, cem edições custam $1,80–$7,20 antes de novas tentativas.

Teste primeiro no Playground

O jeito mais rápido de ver o que um editor faz com sua foto é o Playground da página do modelo, sem código nem gerenciamento de chaves.

1. Abra a página Qwen Image Edit Spicy e fique em Playground, na visualização Form. Entre com uma conta com saldo para executar.
2. Em Input image, arraste um arquivo (JPG, PNG, WEBP ou GIF, até 10 MB), ou use Asset URL e Add URL para um link direto ao arquivo.
3. Em Prompt, diga o que deve ficar e depois a única mudança (os exemplos da próxima seção mostram a redação).
4. Opcionalmente, defina um Seed. Reutilizá-lo com a mesma imagem e instrução torna duas redações comparáveis.
5. Pressione Run model e olhe primeiro a imagem em Output: um resultado suavizado é cobrado como qualquer outro.

Os demais editores têm seus próprios campos no mesmo formulário, como origens adicionais ou uma máscara em Qwen Image 2.1. A visualização JSON ao lado de Form mostra o corpo exato e as abas de código próximas (JavaScript, Python, cURL e outras) exibem a mesma chamada. Uma configuração que funciona aqui pode ser copiada para o projeto.

Depois execute por código

Instale o Python SDK (pip install spicyapi), defina SPICY_API_KEY no ambiente e execute uma edição. O script envia a foto, mostra o preço e espera seu sim antes de criar a tarefa:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment
MODEL = "alibaba/qwen-image-spicy-edit/edit"

source = client.upload_file("photo.jpg")  # or put a public HTTPS link in image_url
body = {
    "image_url": source["uri"],
    "prompt": "Keep the person, pose, framing and room exactly as they are. "
              "Change only the light to warm late-afternoon sun from the window on the left.",
}

quote = client.quote_task(model=MODEL, input_data=body)
print("Estimated", quote["estimatedCost"], "maximum", quote["maxCharge"])
if input("Create the task? [y/N] ").strip().lower() != "y":
    raise SystemExit

task = client.create_task(
    model=MODEL,
    input_data=body,
    idempotency_key=str(uuid.uuid4()),
    quote_id=quote["quoteId"],
    expected_cost=quote["estimatedCost"],
)
print("Resume task:", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise SystemExit(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(a.get("pending") or a.get("unavailable") or not a.get("url") for a in assets):
    raise RuntimeError(f"Task {task['taskId']} has no ready output; check this task before a new run")
print(assets[0]["url"])  # copy the image to your own storage now

A referência do Python SDK e o guia de tarefas cobrem o que vai além dessa chamada; um serviço que deva receber um retorno em vez de esperar pode usar webhooks.

Ou deixe um Agent executar

Quando um assistente deve fazer as edições, as três ferramentas oficiais mostram o preço e pedem confirmação antes de uma chamada paga.

• CLI. Envie a foto, coloque o endereço spicy:// retornado e o prompt em input.json como image_url e prompt, e então:

``bash spicyapi files upload photo.jpg spicyapi tasks create --model alibaba/qwen-image-spicy-edit/edit --input-file input.json --wait ``

Veja a documentação CLI; npx @spicyapi/cli funciona sem instalação.

• Servidor MCP. Adicione o servidor MCP ao assistente e peça: "Edit /path/to/photo.jpg with Qwen Image Edit Spicy: keep the person, pose and room, change only the light to warm late-afternoon sun." Ele envia com spicyapi_upload_file, chama spicyapi_task_create, que aguarda sua confirmação do preço, e depois spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill instala o Agent Skill, que faz o assistente de programação ler o esquema atual do modelo em vez de adivinhar campos.

O que você pode enviar e quanto custa

Uma imagem de origem pode chegar à tarefa de três maneiras:

• Uma URL HTTPS pública, sem envio. Deve retornar o próprio arquivo de imagem sem credenciais; uma página compartilhada de nuvem ou álbum é uma página web e é recusada com 400.
• Uma imagem pequena incorporada, escrita como data:image/png;base64,... no mesmo campo. Deve ser JPEG, PNG, WebP ou GIF, no máximo 1 MiB decodificado e 8192 pixels de cada lado.
• Um upload, para arquivos maiores ou privados: JPEG, PNG, WebP ou GIF até 10 MiB. O envio é gratuito; você paga só pela tarefa que usa o arquivo. Retorna uma URI spicy:// válida por um dia.

Qwen Image 2 aceita apenas JPEG, PNG e WebP. Os campos variam: Qwen Image Edit Spicy e FLUX.1 Dev LoRA recebem uma string image_url, enquanto os demais recebem um array image_urls. Um endpoint rejeita um campo que não lista, em vez de ignorá-lo.

O custo depende do nível de resolução, do número de origens e, em Wan 2.7, de num_outputs; o preço antes da confirmação cobre sua solicitação exata. Veja cotações e o guia de mídia.

Outros endpoints: só a entrada muda

Modelos que aceitam arrays usam image_urls; com mais de uma origem, o prompt define os papéis. Use o mesmo código com o ID de modelo e o corpo abaixo:

{
  "model": "alibaba/qwen-image-3.0/edit",
  "input": {
    "prompt": "Use the person from the first image and the jacket from the second. Keep her face, hair and pose from the first image. Change nothing else.",
    "image_urls": ["spicy://f/fil_...", "spicy://f/fil_..."],
    "aspect_ratio": "3:4",
    "resolution": "2k"
  }
}

Uma edição com máscara em FLUX.1 Dev LoRA adiciona a máscara e a intensidade ao corpo com uma origem:

{
  "model": "black-forest-labs/flux-1-dev-lora/edit",
  "input": {
    "prompt": "A black satin jacket with a high collar, same light as the rest of the photo.",
    "image_url": "spicy://f/fil_...",
    "mask_url": "spicy://f/fil_...",
    "strength": 0.9,
    "seed": 7
  }
}

Um strength menor mantém o resultado mais perto do original; o padrão é 0,8. Copie os valores do esquema atual em cada página de modelo; o guia de geração de imagens explica as diferenças entre endpoints.

Escreva a instrução: primeiro o que fica, depois o que muda

Um endpoint de edição redesenha o que você não especifica. Diga primeiro o que deve permanecer idêntico e depois a única mudança. Listar mais elementos a preservar não custa mais. Em Qwen Image 3.0 e 2.1, defina enable_prompt_expansion como false para uma edição fiel: ele vem ativado e reescreve o prompt como uma descrição mais completa da cena, o que pode diluir a frase de preservação.

• Só luz: “Keep the person, pose, framing and room exactly as they are. Change only the light to warm late-afternoon sun from the window on the left. Keep the colour grade and film grain.”
• Só fundo: “Keep the subject, outfit and crop. Replace the studio wall with dark theatre curtains. Add no logos or text.”
• Várias origens: “Use the person from the first image, the jacket from the second and the street from the third. Keep her face and pose from the first image. Change nothing else.”

Mude uma coisa por passagem; combinar mudanças de estilo e de texto favorece a deriva de identidade. Quando o resultado não acerta:

Quando falha

Estas falhas são específicas da edição; faça a ramificação pelo code numérico ou errorCode da tarefa, não pelo texto da mensagem.

Erros de saldo, tempo limite e outros gerais estão na referência de erros.

O que acontece com os arquivos

Fotos enviadas ficam por um dia e resultados por até 14 dias. Copie o resultado que deseja manter para seu armazenamento assim que a tarefa tiver sucesso. Se a foto deve permanecer menos tempo, a documentação de retenção mostra como encurtar o prazo ou destruir a mídia e o prompt de uma tarefa concluída. Veja também uploads temporários e entrega durável de mídia e o guia inicial da API de imagens e vídeo.

Perguntas frequentes

Existe uma API de imagem para imagem sem censura com ajuste de intensidade?

Sim: FLUX.1 Dev LoRA (strength de 0 a 1, padrão 0,8, com máscara opcional) e o endpoint de edição Z-Image Turbo LoRA. Nos outros, a instrução é o controle e enviar strength retorna 400 strength: is not a supported field.

Preciso enviar a foto?

Não. Um link HTTPS público ou imagem incorporada de até 1 MiB funciona; envie o arquivo quando for maior ou privado.

Uma edição recusada ou que falhou custa dinheiro?

Normalmente não: uma tarefa que falhou libera toda a reserva e um erro de criação não cobra nada. Um resultado suavizado é uma imagem pronta e é cobrado.

A edição manterá o rosto e a pose?

Não há garantia. Diga o que deve ficar, mude uma coisa por passagem e use uma origem quando possível. Seedream 5.0 Pro preservou a pessoa ao mudar luz e roupa, mas posicionou o rosto com menos precisão ao inseri-la em um novo cenário de uma segunda foto; Qwen Image 2 fez bem edições simples, mas reconstruiu alguns móveis nas complexas.

Posso editar a foto de uma pessoa real?

Só com o consentimento documentado dessa pessoa e, sem ele, nunca de forma sexualizada. Vale para todos os modelos; guarde o registro no seu sistema.

Por qual endpoint devo começar?

Qwen Image Edit Spicy para uma foto e uma mudança. Troque apenas se precisar de várias origens, máscara ou strength. Faça uma edição e olhe a imagem antes de mudar de endpoint.

Como continuar

Execute uma edição no Playground com uma foto de teste inofensiva e leia o preço antes de confirmar. Depois escolha o nível de resolução que vai pagar e decida se a produção deve usar um webhook em vez de esperar.

Para prompts do editor Spicy em detalhe, leia o workflow de preservação da origem do Qwen Image Edit Spicy. Para comparar editores de imagens existentes além da API, veja os melhores editores de imagens com IA sem censura. O catálogo de API de imagens sem censura lista todos os modelos disponíveis com sua classificação de conteúdo e preço atual.