Vai al contenuto principale
GET
Elencare i modelli e i prezzi di Devin Desktop

Panoramica

Restituisce i modelli disponibili per l’account chiamante, con i prezzi effettivamente addebitati a tale account, l’indicazione se il tuo team consente attualmente ciascun modello e l’elenco dei modelli consentiti memorizzato per il team. Usalo come fonte di verità programmatica per il pricing dei modelli, anziché copiare i prezzi dalla pagina dei modelli, e come controparte in lettura della Update Model Allowlist API. I prezzi dipendono dal piano e dal modello di billing del chiamante, quindi due team possono ottenere valori diversi per lo stesso modello.
Questo endpoint è in alpha (v2alpha). La struttura della risposta potrebbe cambiare.

Authentication

Passa una chiave API nell’intestazione Authorization:
Usa una chiave API dell’utente di servizio di Devin (cog_...). Il ruolo dell’utente di servizio deve includere l’autorizzazione Use Devin Desktop e l’autorizzazione Windsurf admin (account.windsurf.admin), già inclusa nel ruolo integrato Account Admin, e l’accesso a Devin Desktop deve essere abilitato per l’account.

Richiesta

string
Lascia il campo vuoto per elencare tutti i modelli consentiti dal tuo piano e dal tuo modello di billing, ignorando le restrizioni a livello di team. Il campo allowed di ciascun modello indica se le restrizioni del tuo team attualmente lo consentono.Imposta allowlist per elencare solo i modelli consentiti dall’elenco dei modelli consentiti del tuo team, dai controlli dell’organizzazione e dalle restrizioni di gruppo, in modo che l’elenco corrisponda a quello che gli utenti vedono nel selettore di modelli di Devin Desktop.
string
Limita la risposta a una singola organizzazione del tuo account. In questo caso, i flag allowed riflettono l’override dell’elenco dei modelli consentiti di quell’organizzazione (oppure l’elenco di elementi consentiti a livello di account, se l’organizzazione non ha un override), mentre allowed_model_uids / allowed_model_tags contengono l’override salvato dall’organizzazione stessa (array vuoti se non ne ha uno). L’ETag è specifico dell’organizzazione: passalo come If-Match quando aggiorni quell’organizzazione.Lascia il campo vuoto per usare l’elenco di elementi consentiti a livello di account.
string
Un ETag ottenuto da una risposta precedente. Restituisce 304 Not Modified senza corpo se da allora la risposta non è cambiata.

Esempio di richiesta

Solo i modelli che i tuoi utenti possono selezionare:

Risposta

La risposta include un’intestazione ETag che cambia ogni volta che varia qualcosa nella risposta non filtrata: i modelli disponibili, i loro nomi e prezzi, i loro flag allowed o i campi dell’elenco dei modelli consentiti. Passala come If-Match all’Update Model Allowlist API; il valore è lo stesso indipendentemente da filter.
object[]
Modelli disponibili per il chiamante. I modelli disabilitati non sono inclusi.
string[]
UID dei modelli presenti nell’elenco dei modelli consentiti del tuo team, così come sono memorizzati. Vuoto quando il team consente i modelli solo tramite tag.
string[]
Tag dei modelli presenti nell’elenco dei modelli consentiti del tuo team, così come sono memorizzati, inclusi i tag dei fornitori come provider-anthropic. Un modello è consentito se il suo UID è presente nell’elenco o se ha uno dei tag elencati.

Esempio di risposta

I modelli e i prezzi riportati di seguito servono solo a illustrare la struttura della risposta. Chiama l’endpoint per conoscere i prezzi effettivi.

Risposte di errore

Gli errori vengono restituiti nel formato {"error": "<message>"}.