Le novità che contano mentre sviluppi

Quattro nuovi posti per decidere quale modello usare, tutti costruiti a partire da esecuzioni su questa piattaforma. Classifiche, recensioni e arena le trovi sotto Ranking nell'intestazione del sito, la libreria di prompt sotto Studio.

• Classifiche: ogni modello ha due punteggi separati. Lo Spicy Index (0–100) per ora è provvisorio: valuta solo le capacità, e la qualità dei risultati si aggiungerà quando saranno pronti i nostri test di qualità e i voti dell'arena. Il Freedom Score (0–100) misura fin dove ogni modello arriva, in modo verificato, sulla nostra scala di test sui contenuti. I due non si mescolano mai, e prezzo, velocità e affidabilità compaiono accanto come misure grezze. Ci sono classifiche per video, immagini, LLM, senza censura, miglior rapporto qualità-prezzo e velocità; al 26 settembre sono classificati 53 modelli da 1.672 esecuzioni di test, e i punteggi vengono ricalcolati ogni giorno.
• Recensioni: otto per ora — MiniMax H3, MiniMax H3 Spicy, Seedance 2.5, Seedance 2.5 Spicy, Wan 3.0, Seedream 5.0 Pro, Z-Image Spicy e Grok 4.7. Ognuna mostra risultati reali, un report dei test, quanto costa un risultato utilizzabile e una raccomandazione chiara.
• Arena alla cieca: due risultati anonimi, immagine o video, dallo stesso prompt. Scegli quello che terresti, poi scopri quali modelli li hanno creati. I voti degli utenti che hanno effettuato l'accesso determinano rating Bradley-Terry con intervalli al 95%, aggiornati ogni ora; i modelli con intervalli sovrapposti condividono la posizione. Le posizioni compaiono quando i voti sono sufficienti; fino ad allora i modelli sono elencati per produttore.
• Libreria di prompt: 176 prompt per modelli video e immagine, ognuno con il risultato che ha davvero prodotto. Filtra per modello, task, scena o movimento di camera, poi copia il prompt o aprilo nel playground con tutte le impostazioni già compilate.

La metodologia è pubblica e versionata. Vendiamo l'accesso a ogni modello che classifichiamo, quindi la pagina spiega anche come teniamo questo fattore fuori dai punteggi.

Quattro modifiche al comportamento dei task. Due potrebbero richiedere un intervento da parte tua: se conti sul fatto che richieste identiche diano risultati identici, invia un seed; se gestisci i codici di errore, aggiungi 40310.

Un'esecuzione fallita viene prima riprovata su un'altra route. Molti modelli qui sono serviti da più di una route. Dal 23 settembre, se un'esecuzione fallisce dopo che l'abbiamo accettata e un'altra route serve lo stesso modello con le stesse impostazioni, la eseguiamo lì prima di segnalare l'errore, finché il task ha tempo. Paghi una volta sola, per il risultato che ricevi. Gli errori che si ripeterebbero ovunque, come un rifiuto per diritto d'autore, non vengono riprovati.

I rifiuti spiegano la causa e la soluzione. Quando un modello blocca un risultato per possibile violazione del diritto d'autore o per il volto di una persona reale, errorMessage ora dice quale dei due casi e cosa provare:

• Per i video la causa è quasi sempre la colonna sonora generata: imposta generate_audio: false, togli l'audio di riferimento e non citare brani o artisti reali nel prompt.
• Per le immagini di solito c'è un personaggio noto, un logo o un'opera, nel prompt o in un'immagine di riferimento.
• Alcuni modelli non accettano volti di persone reali nelle immagini di riferimento. Il messaggio lo dice e suggerisce un altro modello o un personaggio illustrato.

errorCode resta content_rejected, l'addebito viene rimborsato e il messaggio segue la lingua degli errori API del tuo account, come ogni altro errore.

Un seed casuale se ometti seed. Dal 24 settembre, sui modelli che accettano seed, una richiesta senza seed ne riceve uno casuale, restituito nell'input del task. Due richieste identiche non restituiscono più lo stesso risultato. Per mantenere le esecuzioni confrontabili, rimanda il seed restituito; un seed fisso non garantisce un risultato identico. Alcuni modelli variano il seed senza restituirlo. Un seed che invii tu viene sempre usato così com'è.

40310 per gli account con email non verificata. Le chiavi di questi account ricevevano finora un 403 generico. Dal 25 settembre ricevono il codice applicativo 40310, con un messaggio che invita ad aprire il link di verifica o a chiederne uno nuovo dalla Console. La chiave funziona appena l'indirizzo è verificato.

Sono disponibili cinque SDK ufficiali, insieme a una CLI, a un server MCP, a un Agent Skill e a un proxy che evita di mettere la chiave nel client. Tutti implementano gli stessi quattro passaggi: preventivo, creazione con chiave di idempotenza, attesa, ritiro.

• Nel vostro albero delle dipendenze non entra quasi nulla. Python e Go usano solo la libreria standard, nemmeno PHP richiede librerie e Java ne porta esattamente una: Jackson.
• L'intero flusso asincrono, non solo la chiamata HTTP: un budget di attesa alla creazione dell'attività, il caricamento in tre passaggi per immagini e video vostri e la verifica della firma dei webhook.
• @spicyapi/cli sfoglia il catalogo, quota il prezzo prima della spesa e scarica i risultati dal terminale. @spicyapi/mcp porta le stesse capacità in Claude Code, Codex, Cursor o qualsiasi client MCP, chiedendovi conferma prima di ogni addebito. L'Agent Skill si installa con npx skills add Spicy-API/spicy-skill e insegna a un assistente di programmazione l'ordine corretto delle operazioni.
• @spicyapi/proxy tiene la chiave sul vostro server. Una chiave compilata in un'applicazione web, mobile o desktop è una chiave pubblica; questo pacchetto è il passaggio lato server che la custodisce al posto suo.

Tutti e cinque sono open source con licenza MIT. Le guide: docs.spicyapi.ai

Due modi per smettere di scrivere cicli di polling. Entrambi sono attivi.

Un budget di attesa alla creazione dell'attività. Aggiungete ?wait=<secondi> a createTask e teniamo la connessione aperta finché l'attività non raggiunge uno stato finale, rispondendo con il record completo, nella stessa forma restituita da recordInfo.

• Budget esaurito: ricevete il solito 202, identico a quando il parametro manca, e da lì interrogate voi.
• Connessione caduta: per l'attività non cambia nulla. Prosegue e viene addebitata come sempre.
• Il tetto è di 60 secondi. I valori superiori vengono limitati anziché rifiutati, e un valore malformato viene ignorato anziché rifiutato: un refuso in un parametro di ottimizzazione non deve far fallire una generazione che sarebbe riuscita.

Conviene sugli endpoint che finiscono in pochi secondi, cioè gran parte del lavoro su immagini ed editing. I modelli video girano spesso per minuti: lì il budget scade e finite comunque per interrogare.

Endpoint webhook a livello di account. Registrate un URL una volta sola insieme agli eventi che vi interessano, e ogni attività corrispondente viene consegnata lì: non serve più passare un URL di callback su ciascuna attività. Un account regge fino a 16 endpoint, ognuno con il proprio segreto di firma. Un 410 Gone dal vostro server disattiva subito quell'endpoint, invece di insistere su un indirizzo che il proprietario ha dismesso. Per ora gli endpoint si gestiscono solo via API; la console non ha ancora una schermata dedicata.

Dettagli: attività · webhook

403 esempi coprono adesso 117 dei 120 endpoint richiamabili. Ognuno è un lavoro realmente eseguito su questa piattaforma — non un'immagine concettuale, non un fermo immagine preso da una scheda di modello — e ognuno porta con sé tre cose:

• Il file finito, servito dal nostro CDN e nel rapporto d'aspetto originale.
• L'oggetto di input completo che lo ha prodotto: prompt, dimensione, durata, ogni parametro, pronto da copiare nella vostra chiamata.
• Una nota in tutte e dieci le lingue dell'interfaccia che spiega perché è stato scelto quell'input: per quale formato è stata scritta la composizione, quale parametro sta facendo il lavoro, che cosa conviene cambiare per primo.

Sulla pagina di ciascun modello si presentano come una parete di risultati da scorrere con un colpo d'occhio; via API tornano sotto examples in GET /console/v1/catalog/models/{slug}.

Scegliere un modello significava finora leggere una tabella di parametri e immaginarsi il risultato. Ora vedete che cosa produce davvero un endpoint e partite da un input che su quello funziona di sicuro.

Sfoglia il catalogo