GetAPI.ONE

GetAPI.ONE aus Python aufrufen

Installieren Sie das offizielle OpenAI-Python-SDK, richten Sie es auf die ONE-Basis-URL aus, senden Sie eine kontrollierte Responses-Anfrage und prüfen Sie das Ergebnis ohne Zugangsdaten im Quellcode.

Projekt und Zugangsdaten vorbereiten

Python 3.10 oder neuer und eine virtuelle Umgebung.
Ein aktivierter GetAPI.ONE‑API-Schlüssel mit bewusst gewähltem Ablaufdatum und Kontingent.
Eine aus dem aktuellen Katalog kopierte Modell-ID mit angegebenem Responses-Endpunkt.

powershell

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

Anfrage konfigurieren und senden

Setzen Sie GETAPI_ONE_API_KEY in der Prozessumgebung; schreiben Sie den Schlüssel nicht in die Datei.
Erstellen Sie den Client mit https://www.getapi.one/v1 als base_url.
Ersetzen Sie den auffälligen Modellplatzhalter durch eine exakte aktuelle Katalog-ID, die Responses angibt.
Führen Sie das Skript nur aus, wenn Sie die mögliche Abrechnung der Anfrage akzeptieren.
Die erste Prüfung deaktiviert SDK-Wiederholungen. Ergänzen Sie nur begrenzte, beobachtbare Wiederholungen, nachdem Sie sicher wiederholbare Operationen bestimmt haben.

python main.py

import os
from openai import OpenAI

api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
    raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")

with OpenAI(
    api_key=api_key,
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.responses.create(
        model="<MODEL_ID_FROM_CURRENT_CATALOG>",
        input="Reply with one short readiness check.",
    )
    print(response.output_text)

Vertrag verstehen

Feld	Erforderlicher Wert
base_url	https://www.getapi.one/v1
api_key	GETAPI_ONE_API_KEY aus der Serverumgebung
model	Exakte ID aus dem aktuellen Katalog
method	client.responses.create

Erwartetes Ergebnis prüfen

Der Prozess endet ohne Authentifizierungs- oder Endpunktfehler.
response.output_text enthält die angeforderte kurze Antwort.
Die GetAPI.ONE‑Konsole zeigt einen passenden Anfrage- oder Nutzungsdatensatz für den Schlüssel.

Häufige Fehler beheben

Symptom	Prüfen
401 oder Authentifizierungsfehler	Kopieren Sie den ONE-Schlüssel erneut, prüfen Sie seine Aktivierung und ob die Umgebungsvariable zu diesem Prozess gehört.
404	Behalten Sie genau ein /v1 in base_url bei und verwenden Sie die Responses-Methode nur für ein Modell, das diesen Endpunkt angibt.
Modell nicht verfügbar oder inkompatibel	Kopieren Sie die exakte ID erneut aus dem aktuellen Katalog; leiten Sie keine Aliase ab.

Integration sicher halten

Führen Sie das SDK ausschließlich in vertrauenswürdigem Servercode oder lokalen Werkzeugen aus, niemals in Browser-JavaScript.
Schließen Sie .env-Dateien von der Versionsverwaltung aus und tauschen Sie einen Schlüssel bei Offenlegung sofort aus.
Verwenden Sie getrennte, begrenzte Schlüssel für Entwicklung und Produktion.

Nächste Schritte

Eine Antwort streamenVerarbeiten Sie SSE-Lebenszyklusereignisse und Endzustände.
Modell auswählenStimmen Sie die Aufgabe auf den Endpunktvertrag im Katalog ab.