Management API Keys

Management API Keys verwalten Projekte, Budgets und Modell-API-Schlüssel und fragen die Projekt- und Schlüsselnutzung im gesamten Team-Konto ab.

Management API Keys verwalten Projekte, Budgets und Modell-API-Schlüssel und fragen die Projekt- und Schlüsselnutzung im gesamten Team-Konto ab.

Welcher Schlüssel gilt für welchen Endpunkt?

Dieser Vergleich betrifft API-Schlüssel. Vorhandene OAuth-Tokens mit Scopes bleiben für Abrechnungsabfragen unterstützt, sofern diese Funktion aktiviert ist.

Management-Schlüssel erstellen

  1. Melden Sie sich in der Console an und wechseln Sie zu einem Team-Konto, dessen Owner Sie sind.
  2. Öffnen Sie Developer → Management API Keys in der Seitenleiste oder direkt diese Seite. Der Eintrag ist nur für den aktuellen Team Owner sichtbar.
  3. Geben Sie Name ein, setzen Sie bei Bedarf Expires (optional) und klicken Sie auf Create key.
  4. Klicken Sie auf Copy key und speichern Sie den neuen mgmt-...-Schlüssel für die Beispiele als ATLASCLOUD_MANAGEMENT_API_KEY. Der geheime Wert wird nur einmal angezeigt.

Woher kommt api_key_id?

api_key_id in der URL ist das Feld id im Format ak_... aus der Antwort von API-Schlüssel erstellen (POST /public/v1/api-keys). Speichern Sie es zum Deaktivieren, Löschen, Ändern des Budgets und Abfragen der Nutzung. Das Feld key (apikey-...) dient Modellaufrufen; Verwaltungsaufrufe verwenden weiterhin mgmt-... im Autorisierungsheader.

Die Antwort beim Erstellen enthält beispielsweise diese Felder:

{
  "id": "ak_0123456789ABCDEFGHIJKL",
  "key": "apikey-REPLACE_WITH_SECRET_RETURNED_ONCE"
}

Setzen Sie dieselbe id in den Pfad ein, etwa /public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage. API_KEY_ID in den Beispielen bezeichnet diesen Wert. Die Public API bietet derzeit keine Schlüsselliste; speichern Sie id deshalb beim Erstellen.

Public API aufrufen

Übergeben Sie den Management-Schlüssel im Header Authorization: Bearer. Anfragen verwenden das Team-Konto, dem der Schlüssel zugeordnet ist.

curl -X POST "https://api.atlascloud.ai/public/v1/projects" \
  -H "Authorization: Bearer $ATLASCLOUD_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"customer-123"}'

Schrittweise Bereitstellung (Englisch).

Schlüssel verwalten

Deaktivierte, gelöschte oder abgelaufene Management-Schlüssel können sich nicht authentifizieren. Auf der Verwaltungsseite können Sie nicht abgelaufene Schlüssel aktivieren oder deaktivieren. Eine Löschung ist endgültig.

Management-Schlüssel gehören dem Team und bleiben gültig, wenn ihr Ersteller das Team verlässt oder nicht mehr Owner ist. Der aktuelle Owner kann Schlüssel früherer Owner verwalten. Deaktivieren oder löschen Sie einen Schlüssel, um den Zugriff zu widerrufen.

Jedes Team kann höchstens 5 nicht gelöschte Management-Schlüssel behalten, einschließlich deaktivierter und abgelaufener Schlüssel. Eine Löschung gibt einen Platz frei.

Last updated on

On this page