Scegliere un'API di immagini senza censura per il lancio: un piano di test di preparazione

In breve: seleziona gli endpoint per task e per l'etichetta di contenuto che il catalogo live assegna a ciascuno, poi prova più volte i tuoi brief e conta i risultati utilizzabili, non i task completati. Un endpoint etichettato come «attenuato» restituisce un task riuscito e fatturato con un'immagine attenuata, quindi uno stato verde non dimostra nulla. E SpicyAPI non scansiona né le richieste né i risultati: i controlli che mantengono il tuo prodotto dentro la legge e dentro le tue stesse regole spettano a te. Le etichette e i prezzi qui sotto sono di inizio ottobre 2026; fa fede il catalogo live delle API di generazione di immagini senza censura.

Cosa significano le etichette di contenuto per un'integrazione

Ogni endpoint di immagini del catalogo porta una di quattro etichette. Dei 59 endpoint di immagini attivi nel catalogo, 40 sono etichettati senza censura, 3 attenuati, 12 filtrati e 4 non portano etichetta (rimozione dello sfondo, aumento di risoluzione e utilità simili).

L'etichetta appartiene a un endpoint, non a una famiglia: Wan 2.7 Pro da testo a immagine è attenuato mentre il suo endpoint di editing è senza censura, quindi un benchmark che mescola i due confronta due promesse diverse. È anche puramente informativa: ti dice cosa aspettarti, non cosa è garantito.

Poiché non c'è una scansione della piattaforma, le regole incondizionate della policy sui contenuti e sull'uso diventano compito del tuo prodotto: nulla di sessualizzato che coinvolga un minore, nessuna rappresentazione intima di una persona reale identificabile senza consenso documentato (face swap compreso), nessuna impersonazione. Metti davanti alla chiamata i controlli sull'età, i registri di consenso per ogni input di una persona reale e un modo per gli utenti di segnalare contenuti. La versione lunga si trova in «Building on a less restrictive model» (per ora solo in inglese).

Seleziona per il lavoro, poi per etichetta e prezzo

Scrivi una frase per il tuo primo flusso di lavoro, per esempio «modifica un'immagine di moda con licenza, cambiando solo lo sfondo». Ti dice quale task ti serve; i task sono voci di catalogo distinte con campi distinti. I prezzi sono il prezzo «da» più basso di ogni pagina; risoluzione, riferimenti e opzioni modificano l'importo finale.

Questa è una rosa corta, non una classifica. Per un prodotto per adulti, parti dalle righe senza censura che corrispondono al tuo task. Una riga attenuata funziona solo quando i tuoi brief restano ben dentro i suoi limiti; una riga filtrata si adatta alla metà SFW (adatta a tutti i contesti) di un prodotto misto. Prefect Pony XL si aspetta tag separati da virgole e sette dimensioni fisse, quindi dagli prompt in stile tag invece di brief frasali scritti per un modello fotorealistico.

Ogni pagina di modello rimanda a un rapporto di test, per esempio Z-Image Spicy e Seedream 5.0 Pro, con output reali che vanno da suggestivi a scene adulte intense e un tempo mediano (circa 18 s per Z-Image Spicy, circa 70 s per Seedream 5.0 Pro). Leggili prima e poi misura l'attesa dalla creazione di un task a un risultato scaricabile, misurata dai tuoi stessi server.

Prova i tuoi brief, non un sostituto gentile

Scrivi i brief all'intensità che il tuo prodotto offrirà davvero, con personaggi adulti immaginari o con input che sei autorizzato a usare. Un insieme di sostituti SFW può far passare un endpoint attenuato, perché l'attenuazione si vede solo quando un brief supera i limiti del modello. Tieni i brief in un repository di test privato, non in ticket o documenti pubblici. Esegui ogni fixture tre volte: abbastanza per far emergere l'instabilità, abbastanza economico da ripetere dopo una modifica.

Concorda prima del test una regola di superamento scritta: soggetto e composizione corrispondono al brief, le aree protette di una modifica restano invariate, l'intensità non è più tenue di quanto richiesto e non ci sono difetti di anatomia o di lettering che un cliente noterebbe. Registra due numeri per candidato: il tasso di risultati utilizzabili (gli output che superano la regola, divisi per i task completati) e il costo per risultato utilizzabile (spesa totale divisa per lo stesso conteggio), che rende confrontabile un endpoint economico ma attenuato con uno più costoso ma affidabile. Per una griglia di valutazione più completa, usa la guida al benchmark delle API di immagini.

Prova prima una fixture nel Playground

1. Apri la pagina di un endpoint della rosa corta, per esempio Z-Image Spicy da testo a immagine, e accedi con un account con fondi. Il modulo è nella pagina.
2. Incolla la fixture 01 in Prompt e imposta la dimensione del frame (Width e Height qui; altri endpoint usano un campo di rapporto d'aspetto o di dimensione).
3. Leggi il prezzo sotto il modulo, premi Run e ripeti l'esecuzione altre due volte per vedere la dispersione.
4. Esegui le fixture 02 e 03 allo stesso modo, poi giudica ogni risultato con la tua regola di superamento prima di scrivere una riga di codice.

Fotogrammi di film che attraversano un proiettore e formano un'immagine finita.

Poi automatizza lo stesso test

Una volta che una fixture si comporta come previsto nel Playground, eseguila da un file. Un preventivo è gratuito: valida esattamente il corpo che invieresti, non crea nulla e non trattiene fondi.

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

Crea il task dallo stesso file con tasks create; nuovi tentativi, polling e risultati sono nella documentazione dei task e nella documentazione della CLI.

Oppure fai eseguire il test a un agente. Con il server MCP un assistente richiede un preventivo tramite spicyapi_task_quote, e npx skills add spicyapi-ai/spicy-skill installa l'Agent Skill che gli fa leggere lo schema live prima di ogni chiamata.

Cinque fatti cambiano il modo in cui costruisci il tuo harness di test:

• Un preventivo è il test più economico. Passa ogni fixture al preventivo prima della prima esecuzione a pagamento, e ricontrolla l'etichetta di ogni endpoint in CI, perché le etichette possono cambiare.
• Ogni endpoint accetta solo i propri nomi di campo; i campi sconosciuti vengono rifiutati. Solo la dimensione di output si scrive in tre modi: Z-Image accetta aspect_ratio, Prefect Pony XL un unico size, Z-Image Spicy width e height. Costruisci un adattatore per endpoint dal suo schema live, non una richiesta condivisa.
• Le immagini di riferimento possono far salire il prezzo. Ogni immagine oltre la prima si somma al preventivo di Seedream 5.0 Pro, quindi chiedi il preventivo del corpo esatto con il numero reale di immagini di riferimento.
• succeeded non vuol dire utilizzabile. Vuol dire solo che il modello ha restituito qualcosa; rivedi ogni risultato con la tua regola di superamento, ed è lì che le immagini attenuate vengono intercettate. I rifiuti di norma non vengono addebitati.
• Una creazione scaduta nel timeout può esistere comunque. Rinviala con la stessa chiave di idempotenza invece di pagare due volte; è quello il caso della fixture 08.

I link di download e i file generati scadono, quindi copia le immagini approvate nel tuo archivio con accanto il riferimento del task (articolo sulla conservazione dei media). Per polling contro webhook, vedi la guida «Polling versus webhooks» (per ora solo in inglese).

Come fare la scelta

Scarta gli endpoint che non pubblicano il task di cui il tuo primo flusso di lavoro ha bisogno. Scarta quelli che falliscono le fixture 07 e 08. Confronta il resto con la stessa base di brief su tasso di risultati utilizzabili e costo per risultato utilizzabile. Preferisci l'endpoint senza censura con il tasso migliore per il tuo intervallo di intensità; tieni un endpoint attenuato o filtrato solo dove i suoi limiti sono adatti al brief, e dillo nei testi del tuo prodotto invece di promettere «qualsiasi cosa». Un fallback deve superare le stesse fixture.

Domande frequenti

Un endpoint senza censura è automaticamente la scelta migliore per la mia API?

No. Significa che non è dichiarato alcun filtro, non che segua il tuo brief o costi meno per immagine utilizzabile.

Come faccio a sapere se un endpoint attenuato ha addolcito la mia immagine?

Confronta la fixture 02 con la fixture 01: un endpoint attenuato mantiene il soggetto ma perde l'intensità che hai chiesto. Nulla nella risposta del task lo segnala.

Un rifiuto costa qualcosa?

Di norma no: i task falliti liberano per intero l'importo trattenuto. Alcune pagine di modello dicono che certi rifiuti vengono addebitati, quindi controlla il costo del task prima di dare per scontato che sia stato gratis.

Posso testare con foto vere di clienti?

Non all'inizio. Usa input autorizzati o sintetici. Ogni input di una persona reale richiede un consenso documentato per la modifica e la distribuzione specifiche, e tutto ciò che riguarda un minore non è mai consentito.

Un task completato significa che posso mostrare l'immagine agli utenti?

No. Un task completato significa solo che il modello ha restituito qualcosa. Verificalo con la tua regola di superamento, che è anche il punto in cui un risultato attenuato viene intercettato, e copia le immagini approvate nel tuo archivio prima di consegnarle.

Ogni quanto devo ripetere i controlli?

Prima del lancio e dopo qualsiasi modifica a modello, etichetta, prezzo o schema.