Escolher uma API de imagens sem censura para o lançamento: um plano de teste de prontidão

Resumindo: faça uma shortlist de endpoints por tarefa e pelo rótulo de conteúdo que o catálogo ao vivo dá a cada um, depois teste seus próprios briefings algumas vezes cada e conte resultados úteis, não tarefas concluídas. Um endpoint rotulado como "suavizado" devolve uma tarefa bem-sucedida e cobrada com uma imagem atenuada, então um status verde não prova nada. E a SpicyAPI não faz varredura das requisições nem dos resultados, de modo que as verificações que mantêm seu produto dentro da lei e das suas próprias regras dependem de você. Os rótulos e os preços abaixo são de início de outubro de 2026; o catálogo ao vivo de APIs de geração de imagens sem censura é a fonte da verdade.

O que os rótulos de conteúdo significam para uma integração

Cada endpoint de imagem do catálogo carrega um de quatro rótulos. Dos 59 endpoints de imagem ativos no catálogo, 40 são rotulados como sem censura, 3 como suavizados, 12 como filtrados e 4 não têm rótulo (remoção de fundo, ampliação de resolução e utilitários semelhantes).

O rótulo pertence a um endpoint, não a uma família: Wan 2.7 Pro de texto para imagem é suavizado enquanto o endpoint de edição dele é sem censura, então um benchmark que mistura os dois compara duas promessas diferentes. Ele também é apenas informativo: diz o que esperar, não o que é garantido.

Como não existe varredura da plataforma, as regras incondicionais da política de conteúdo e uso passam a ser responsabilidade do seu produto: nada sexualizado que envolva um menor, nenhuma representação íntima de uma pessoa real identificável sem consentimento documentado (troca de rosto inclusa), nenhuma falsificação de identidade. Coloque antes da chamada as verificações de idade, os registros de consentimento para qualquer entrada de uma pessoa real e um canal para os usuários denunciarem conteúdo. A versão longa está em "Building on a less restrictive model" (só em inglês por enquanto).

Shortlist pelo trabalho, depois pelo rótulo e pelo preço

Escreva uma frase para o seu primeiro fluxo de trabalho, por exemplo "editar uma imagem de moda licenciada, mudando apenas o fundo". Ela diz de qual tarefa você precisa; tarefas são entradas de catálogo separadas, com campos separados. Os preços são o menor preço "a partir de" de cada página; resolução, referências e opções mudam o valor final.

Esta é uma shortlist, não um ranking. Para um produto voltado a adultos, comece pelas linhas sem censura que combinam com a sua tarefa. Uma linha suavizada só funciona quando os seus briefings ficam bem dentro dos limites dela; uma linha filtrada serve para a metade SFW de um produto misto. O Prefect Pony XL espera tags separadas por vírgula e sete tamanhos fixos, então alimente-o com prompts no estilo de tags, e não com briefings em frase escritos para um modelo fotorrealista.

Cada página de modelo aponta um relatório de teste, por exemplo Z-Image Spicy e Seedream 5.0 Pro, com saídas reais que vão de sugestivas a cenas adultas intensas e um tempo mediano (cerca de 18 s para Z-Image Spicy, cerca de 70 s para Seedream 5.0 Pro). Leia-os primeiro e depois meça a espera entre a criação de uma tarefa e um resultado baixável, medida a partir dos seus próprios servidores.

Teste os seus próprios briefings, não um substituto educado

Escreva os briefings na intensidade que o seu produto realmente vai oferecer, com personagens adultos fictícios ou com entradas que você está autorizado a usar. Um conjunto de substitutos SFW pode fazer passar um endpoint suavizado, porque a suavização só aparece quando um briefing ultrapassa os limites do modelo. Guarde os briefings em um repositório de testes privado, não em tickets nem em documentos públicos. Execute cada fixture três vezes: o bastante para expor a instabilidade e barato o bastante para repetir depois de uma mudança.

Combine uma regra de aprovação escrita antes da execução: assunto e composição batem com o briefing, as regiões protegidas de uma edição ficam sem alteração, a intensidade não está mais branda do que o pedido e não há defeito de anatomia ou de texto na imagem que um cliente notaria. Registre dois números por candidato: a taxa de resultados úteis (as saídas que aprovam, divididas pelas tarefas que terminaram) e o custo por resultado útil (o gasto total dividido pela mesma contagem), o que torna comparável um endpoint barato mas suavizado com um mais caro, porém confiável. Para uma rubrica de pontuação mais completa, use o guia de benchmark de API de imagens.

Teste primeiro uma fixture no Playground

1. Abra a página de um endpoint da shortlist, por exemplo Z-Image Spicy de texto para imagem, e entre com uma conta com saldo. O formulário está na página.
2. Cole a fixture 01 em Prompt e defina o tamanho do quadro (Width e Height aqui; outros endpoints usam um campo de proporção ou de tamanho).
3. Leia o preço abaixo do formulário, pressione Run e repita a execução mais duas vezes para ver a dispersão.
4. Execute as fixtures 02 e 03 do mesmo jeito e julgue cada resultado pela sua regra de aprovação antes de escrever qualquer código.

Quadros de filme passando por um projetor e formando uma imagem final.

Depois automatize o mesmo teste

Depois que uma fixture se comportar como se espera no Playground, execute-a a partir de um arquivo. Uma cotação é gratuita: ela valida o corpo exato que você enviaria, não cria nada e não retém fundos.

spicyapi tasks quote --model alibaba/z-image-spicy/text-to-image --input-file fixture-01.json

Crie a tarefa a partir do mesmo arquivo com tasks create; novas tentativas, sondagem e resultados estão na documentação de Tasks e na documentação da CLI.

Ou deixe um agente executar. Com o servidor MCP um assistente cota por meio de spicyapi_task_quote, e npx skills add spicyapi-ai/spicy-skill instala o Agent Skill que faz com que ele leia o esquema ao vivo antes de cada chamada.

Cinco fatos mudam a forma de você montar o seu arnês de testes:

• Uma cotação é o teste mais barato. Passe cada fixture por ela antes da primeira execução paga e reconfira o rótulo de cada endpoint no CI, porque os rótulos podem mudar.
• Cada endpoint só aceita os próprios nomes de campo; campos desconhecidos são rejeitados. Só o tamanho de saída tem três formas de escrita: Z-Image aceita aspect_ratio, o Prefect Pony XL um único size, e o Z-Image Spicy width e height. Monte um adaptador por endpoint a partir do esquema ao vivo, não uma requisição compartilhada.
• Imagens de referência podem elevar o preço. Cada uma além da primeira entra na cotação do Seedream 5.0 Pro, então cote o corpo exato com o número real de imagens de referência.
• succeeded não significa utilizável. Só significa que o modelo devolveu alguma coisa; revise cada resultado pela sua regra de aprovação, que é onde as imagens suavizadas são detectadas. Recusas normalmente não são cobradas.
• Uma criação que dá timeout pode ainda existir. Reenvie-a com a mesma Idempotency-Key em vez de pagar duas vezes; é isso que a fixture 08 verifica.

Links de download e arquivos gerados expiram, então copie as imagens aprovadas para o seu próprio armazenamento com a referência da tarefa ao lado delas (artigo sobre retenção de mídia). Para sondagem versus webhooks, veja o guia "Polling versus webhooks" (só em inglês por enquanto).

Como tomar a decisão

Descarte os endpoints que não publicam a tarefa de que o seu primeiro fluxo de trabalho precisa. Descarte os que reprovam nas fixtures 07 e 08. Compare o restante pela taxa de resultados úteis e pelo custo por resultado útil nos mesmos briefings. Prefira o endpoint sem censura com a melhor taxa para a sua faixa de intensidade; mantenha um endpoint suavizado ou filtrado apenas onde os limites dele servirem ao briefing, e diga isso nos textos do seu produto em vez de prometer "qualquer coisa". Um fallback precisa passar nas mesmas fixtures.

Perguntas frequentes

Um endpoint sem censura é automaticamente a melhor escolha para a minha API?

Não. Significa que nenhum filtro foi declarado, não que ele seguirá o seu briefing nem que custa menos por imagem utilizável.

Como sei que um endpoint suavizado suavizou a minha imagem?

Compare a fixture 02 com a fixture 01: um endpoint suavizado mantém o assunto, mas perde a intensidade que você pediu. Nada na resposta da tarefa sinaliza isso.

Uma recusa custa alguma coisa?

Normalmente não: tarefas com falha liberam a retenção inteira. Algumas páginas de modelo dizem que certas recusas são cobradas, então verifique o custo da tarefa antes de supor que foi de graça.

Posso testar com fotos reais de clientes?

Não no começo. Use entradas autorizadas ou sintéticas. Qualquer entrada de uma pessoa real exige consentimento documentado para a edição e a distribuição específicas, e tudo o que envolve um menor nunca é permitido.

Uma tarefa concluída significa que posso mostrar a imagem aos usuários?

Não. Uma tarefa concluída só significa que o modelo devolveu alguma coisa. Verifique-a pela sua regra de aprovação, que também é onde um resultado suavizado é detectado, e copie as imagens aprovadas para o seu próprio armazenamento antes de entregá-las.

De quanto em quanto tempo devo repetir as verificações?

Antes do lançamento, e depois de qualquer mudança de modelo, rótulo, preço ou esquema.