Zum Hauptinhalt springen
POST
/
api
/
v1
/
UsageConfig
Nutzung konfigurieren
curl --request POST \
  --url https://server.codeium.com/api/v1/UsageConfig \
  --header 'Content-Type: application/json' \
  --data '{
  "service_key": "<string>",
  "clear_add_on_credit_cap": true,
  "set_add_on_credit_cap": 123,
  "team_level": true,
  "group_id": "<string>",
  "user_email": "<string>"
}'

Übersicht

Legen Sie Nutzungsobergrenzen für Add-on‑Guthaben Ihrer Organisation fest oder entfernen Sie sie. Sie können diese Einstellungen auf Team-Ebene, für bestimmte Gruppen oder einzelne Nutzer anwenden.

Anfrage

service_key
string
required
Ihr Service Key mit den entsprechenden Berechtigungen

Konfiguration des Kreditlimits (eine Option auswählen)

clear_add_on_credit_cap
boolean
Auf true setzen, um das bestehende Add-on-Kreditlimit zu zurückzusetzen
set_add_on_credit_cap
integer
Neues Add-on-Kreditlimit festlegen (Ganzzahl)
Sie müssen entweder clear_add_on_credit_cap oder set_add_on_credit_cap angeben, aber nicht beides.

Bereichskonfiguration (eine Option auswählen)

team_level
boolean
Auf true setzen, um die Konfiguration auf Teamebene anzuwenden
group_id
string
Die Konfiguration auf eine bestimmte Gruppe anwenden, indem die Gruppen-ID angegeben wird
user_email
string
Die Konfiguration auf einen bestimmten Benutzer anwenden, indem dessen E-Mail-Adresse angegeben wird
Es muss eines von team_level, group_id oder user_email angegeben werden, um den Geltungsbereich festzulegen.

Beispielanfrage – Kreditlimit für ein Team festlegen

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 10000,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig

Beispielanfrage – Guthabenlimit für eine Gruppe festlegen

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 5000,
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/UsageConfig

Beispielanfrage – Kreditobergrenze für einen Benutzer festlegen

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 1000,
  "user_email": "user@example.com"
}' \
https://server.codeium.com/api/v1/UsageConfig

Beispielanfrage – Klarer Kreditrahmen

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "clear_add_on_credit_cap": true,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig

Antwort

Der Antwortinhalt ist leer. Ein 200-Statuscode zeigt an, dass der Vorgang erfolgreich war.

Fehlerantworten

Häufige Fehlerfälle:
  • Ungültiger Service Key oder unzureichende Berechtigungen
  • Sowohl clear_add_on_credit_cap als auch set_add_on_credit_cap übergeben
  • Weder clear_add_on_credit_cap noch set_add_on_credit_cap übergeben
  • Mehrere Scope-Parameter übergeben
  • Kein Scope-Parameter übergeben
  • Ungültige Gruppen-ID oder Benutzer-E-Mail-Adresse
  • Rate Limit überschritten