GetAPI.ONE‑API-Anfrage senden

Voraussetzungen und Grenzen

• Ein eingeschränkter GetAPI.ONE‑Schlüssel, gespeichert in GETAPI_ONE_API_KEY.
• Ein aktuelles Katalogmodell, bei dem der benötigte Endpunkttyp ausdrücklich aufgeführt ist.
• Eine Befehlszeile mit installiertem curl und erlaubtem ausgehendem HTTPS-Zugriff auf www.getapi.one.
• Akzeptieren Sie, dass eine echte Anfrage Nutzungskosten verursachen kann. Die Beispiele wurden ohne Modellanfragen geprüft.

• Schlüssel erstellen und laden
• Ein zum Endpunkt passendes Modell auswählen

1. Angegebenen Endpunkt wählen

Andere Protokollfamilien verwenden andere Pfade und Anfragekörper. Folgen Sie dem Endpunkt auf der gewählten Modellseite; passen Sie Anthropic-, Gemini-, Bild- oder Videoaufrufe nicht pauschal an die beiden obigen Beispiele an.

2. Beispiel für die Responses API

Verwenden Sie dies erst, nachdem Sie ein Katalogmodell mit aufgeführtem Responses-Endpunkt gewählt haben. Ersetzen Sie YOUR_RESPONSES_MODEL vor der Ausführung.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Beispiel für Chat Completions

Verwenden Sie dieses Beispiel nur, wenn beim gewählten Katalogmodell der OpenAI-Chat-Endpunkt aufgeführt ist. Ersetzen Sie YOUR_CHAT_MODEL vor der Ausführung.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. Ergebnis prüfen

1. Lesen Sie zuerst den HTTP-Status. Ein 2xx-Status bedeutet, dass das Gateway die HTTP-Anfrage angenommen und abgeschlossen hat; Ihr Client muss das Antwortobjekt dennoch auf die erwartete Ausgabe prüfen.
2. Prüfen Sie bei Responses den zurückgegebenen Status und die Ausgabestruktur. Prüfen Sie bei Chat Completions die zurückgegebene choices-Struktur. Setzen Sie nicht für beide Protokolle dieselbe Antwortstruktur voraus.
3. Öffnen Sie das Anfrage- oder Nutzungsprotokoll von GetAPI.ONE und gleichen Sie Zeitpunkt, Endpunkt, Modell und gegebenenfalls Anfragekennung ab.

Streaming und Wiederholungsversuche

Streaming verändert die Antwortübertragung und Ereignisverarbeitung; die Unterstützung hängt vom gewählten Endpunkt und Modell ab. Beginnen Sie ohne Streaming und prüfen Sie Protokollreferenz und Modellseite, bevor Sie Streaming-Parameter ergänzen.

• Wiederholen Sie Authentifizierungs-, Kontingent-, Berechtigungs- oder Modellauswahlfehler nicht automatisch.
• Klären Sie vor der Wiederholung nach einer Zeitüberschreitung oder einem Upstream-Fehler, ob die ursprüngliche Anfrage bereits verarbeitet worden sein könnte und ob sich die Aktion sicher wiederholen lässt.
• Begrenzen Sie in Anwendungen Wiederholungsversuche und verwenden Sie Warteintervalle mit Backoff; bewahren Sie Anfragekennungen und Zeitstempel zur Diagnose auf.

Fehlerfälle

• Checkliste zur Fehlerbehebung
• Supportbericht vorbereiten