Vai al contenuto principale

Glossario per sviluppatori

Capisci l’API prima di integrarla.

Definizioni pratiche per scegliere un modello, gestire gli stati delle attività, verificare i callback, stimare il consumo e proteggere i media dei tuoi utenti.

01

API di generazione asincrona

Definizione

Un’API che accetta una richiesta di media, restituisce un taskId duraturo e si conclude fuori dalla richiesta HTTP originale.

Nota di implementazione

Salva il taskId prima del polling o dell’attesa del webhook. queued e running sono in corso; succeeded, failed ed expired sono stati finali. Un’attività accettata non si può annullare.

Pagina correlata →
02

Chiave di idempotenza

Definizione

Un identificativo generato dal client che fa convergere gli invii ripetuti su un’unica attività logica, invece di creare lavoro fatturabile in doppio.

Nota di implementazione

Riusa la stessa chiave solo per la stessa richiesta già validata, conservala insieme all’attività e restituisci il risultato originale quando arriva un nuovo tentativo.

Pagina correlata →
03

Firma del webhook

Definizione

Un valore crittografico allegato a un callback, con cui chi lo riceve verifica che l’evento arrivi dall’API e non sia stato alterato lungo il percorso.

Nota di implementazione

Verifica il corpo grezzo della richiesta, rifiuta i timestamp vecchi e deduplica gli eventId prima di cambiare lo stato dell’attività o dell’addebito.

Pagina correlata →
04

Schema del modello

Definizione

La specifica leggibile dalle macchine che descrive campi accettati, tipi, limiti, valori predefiniti e forma dell’output di un modello.

Nota di implementazione

Genera moduli e validazione lato server dallo schema pubblicato, ma fissa o registra la versione dello schema usata per ogni attività.

Pagina correlata →
05

Immagine di riferimento

Definizione

Un’immagine in input che guida identità, composizione, stile o movimento in una generazione di immagine o video.

Nota di implementazione

Raccogli provenienza e consenso, verifica formato e dimensione ed evita di trattare un riferimento come permesso di riprodurre le sembianze di una persona reale.

Pagina correlata →
06

Prezzi a consumo

Definizione

Una fatturazione basata sul consumo misurato. Ogni modello dichiara l’unità applicabile: l’immagine, il secondo generato, il megapixel, il token o la richiesta.

Nota di implementazione

Mostra l’unità e la stima prima dell’invio; importi minimi, durata e numero di risultati possono cambiare il costo finale.

Pagina correlata →
07

Modello AI con meno filtri sui contenuti

Definizione

Un’opzione di singoli modelli con meno filtri sui contenuti, che può elaborare una gamma più ampia di contenuti; l’etichetta è informazione di prodotto, non approvazione della piattaforma.

Nota di implementazione

Prima di inviare una richiesta, implementa i controlli su età, consenso, persone reali e giurisdizione che i tuoi utenti e il tuo servizio richiedono.

Pagina correlata →

Pronto a integrare un modello?

Guarda input, esempi e prezzi attuali del modello, poi controlla la stima per le tue impostazioni reali prima di eseguire.