Zum Hauptinhalt springen
GET
Devin Desktop-Modelle und Preise auflisten

Übersicht

Gibt die Modelle zurück, die dem aufrufenden Account zur Verfügung stehen, samt den Preisen, die diesem Account tatsächlich berechnet werden, der Angabe, ob Ihr Team das jeweilige Modell aktuell erlaubt, sowie der gespeicherten Allowlist des Teams. Nutzen Sie diesen Endpunkt als programmatische Source of Truth für Modellpreise, anstatt Preise von der Modelle-Seite zu übernehmen, und als lesendes Gegenstück zur Update Model Allowlist API. Die Preise hängen vom Plan und Abrechnungsmodell des Aufrufers ab, daher können zwei Teams für dasselbe Modell unterschiedliche Werte erhalten.
Dieser Endpunkt befindet sich im Alpha-Stadium (v2alpha). Die Struktur der Antwort kann sich ändern.

Authentifizierung

Übergeben Sie einen API-Schlüssel im Authorization-Header:
Verwenden Sie einen Devin-Service-Benutzer-API-Schlüssel (cog_...). Die Rolle des Service-Benutzers muss die Berechtigung Use Devin Desktop umfassen, und der Zugriff auf Devin Desktop muss für das Konto aktiviert sein.

Request

string
Ohne Angabe werden alle Modelle aufgelistet, die Ihr Plan und Ihr Abrechnungsmodell zulassen – teamweite Beschränkungen bleiben dabei unberücksichtigt. Das Feld allowed jedes Modells gibt an, ob die Beschränkungen Ihres Teams das Modell aktuell zulassen.Setzen Sie den Wert auf allowlist, um nur die Modelle aufzulisten, die die Allowlist Ihres Teams, die Vorgaben der Organisation sowie Gruppenbeschränkungen zulassen. Die Liste entspricht dann dem, was Nutzer in der Modellauswahl von Devin Desktop sehen.
string
Ein ETag aus einer früheren Antwort. Hat sich die Antwort seitdem nicht geändert, wird 304 Not Modified ohne Body zurückgegeben.

Beispielanfrage

Nur die Modelle, die Ihre Nutzer auswählen können:

Antwort

Die Antwort enthält einen ETag-Header, der sich ändert, sobald sich irgendetwas an der ungefilterten Antwort ändert: an den verfügbaren Modellen, ihren Namen und Preisen, ihren allowed-Flags oder den Allowlist-Feldern. Übergeben Sie ihn als If-Match an die Update Model Allowlist API; er ist unabhängig von filter stets derselbe.
object[]
Für den Aufrufer verfügbare Modelle. Deaktivierte Modelle sind nicht enthalten.
string[]
Modell-UIDs auf der Allowlist Ihres Teams in gespeicherter Form. Leer, wenn das Team Modelle ausschließlich über Tags zulässt.
string[]
Modell-Tags auf der Allowlist Ihres Teams in gespeicherter Form, einschließlich Anbieter-Tags wie provider-anthropic. Ein Modell ist zulässig, wenn seine UID aufgeführt ist oder es eines der aufgeführten Tags trägt.

Beispielantwort

Die folgenden Modelle und Preise dienen nur zur Veranschaulichung des Antwortformats. Rufen Sie den Endpunkt auf, um Ihre tatsächlichen Preise zu erhalten.

Fehlerantworten

Fehler werden als {"error": "<message>"} zurückgegeben.