GetAPIGetAPI.ONE
GetAPI.ONE‑API-Schlüssel erstellen und schützen
Erstellen Sie einen benannten Schlüssel mit begrenztem Geltungsbereich, wählen Sie Gruppe, Ablaufdatum und Kontingent, speichern Sie ihn außerhalb des Quellcodes, überprüfen Sie ihn und widerrufen Sie ihn sicher.
Voraussetzungen
- Melden Sie sich bei GetAPI.ONE an und prüfen Sie, ob Sie die Konsole öffnen können.
- Prüfen Sie, ob das Konto über nutzbares Guthaben oder ein passendes Paket verfügt.
- Legen Sie fest, welcher einzelne Client oder welches Projekt diesen Schlüssel nutzt und wo dessen geheime Umgebungsvariable gespeichert wird.
Schlüssel erstellen
- Öffnen Sie API-Schlüssel in der Konsolennavigation und wählen Sie die Erstellung eines API-Schlüssels.
- Geben Sie einen aussagekräftigen Namen ein, etwa Client und Umgebung. Schreiben Sie den geheimen Schlüssel selbst nicht in den Namen.
- Wählen Sie die Gruppe, die für das vorgesehene Modell und den Endpunkt erforderlich ist.
- Legen Sie einen Schlüssel, ein konkretes Ablaufdatum und ein zur erwarteten Nutzung passendes Kontingent fest. Prüfen Sie erweiterte Einschränkungen nur, wenn der Client sie benötigt.
- Speichern Sie die Änderungen und kehren Sie zur Schlüsselliste zurück.
Kopieren und speichern
Nach der Erstellung zeigt die Liste Schlüsselname, maskierten Schlüssel, Gruppe, Status und Verwaltungsaktionen. Bei GetAPI.ONE wird der Schlüssel nicht nur einmal angezeigt: Sie können ihn später erneut aus der Schlüsselliste kopieren und weiter verwalten.
export GETAPI_ONE_API_KEY="replace-with-your-private-key"$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"Schlüssel mit der ONE-Adresse kombinieren
| Verwendung | Wert |
|---|---|
| Website-/API-Ursprung | https://www.getapi.one |
| Basis-URL für Codex / CCSwitch | https://www.getapi.one/v1 |
| Zugangsdaten | Aus der GetAPI.ONE‑Schlüsselliste kopieren |
Prüfen, ohne den Schlüssel offenzulegen
- Konfigurieren Sie einen Client oder verwenden Sie die Anleitung für direkte Anfragen. Ersetzen Sie das Platzhaltermodell durch einen Katalogeintrag, der den benötigten Endpunkt unterstützt.
- Senden Sie nur eine minimale Anfrage, deren mögliche Kosten Sie bewusst akzeptieren; beim Erstellen dieser Anleitung wurde keine Anfrage gesendet.
- Prüfen Sie eine gültige Antwort sowie den Anfrage- oder Nutzungsdatensatz in der Konsole. Maskieren Sie den Schlüssel, bevor Sie Diagnoseausgaben speichern.
Fehler, Austausch und Widerruf
- 401 / Unauthorized: Kopieren Sie den Schlüssel erneut, entfernen Sie versehentliche Leerzeichen, prüfen Sie seine Aktivierung und stellen Sie sicher, dass er mit der ONE-Adresse verwendet wird.
- Modell nicht gefunden oder Zugriff verweigert: Prüfen Sie, ob die Schlüsselgruppe das Modell zugänglich macht und ob für das Modell der vom Client verwendete Endpunkt angegeben ist.
- Kontingent- oder Ablauffehler: Prüfen Sie Schlüssellimit und Ablaufdatum, bevor Sie diese erweitern; kontrollieren Sie auch Kontoguthaben und Ratenbegrenzungen.
- Bei vermuteter Offenlegung: Deaktivieren oder löschen Sie den betroffenen Schlüssel, erstellen Sie einen Ersatz mit den geringsten erforderlichen Rechten, aktualisieren Sie den Client und prüfen Sie, dass der alte Schlüssel nicht mehr verwendbar ist.