GPT-6 Astra mit OmniaKey verwenden

Dieses Tutorial führt Sie von einem neuen OmniaKey-Konto bis zur ersten erfolgreichen Anfrage an GPT-6 Astra. Es behandelt serverseitige API-Aufrufe und die Codex CLI. Ein OmniaKey API-Key ist kein ChatGPT-Abonnement und kann nicht auf der ChatGPT-Website verwendet werden.

Der aktuelle Astra-Leitfaden von OpenAI beginnt mit der Responses API. Chat Completions bleibt für normalen Text verfügbar, doch Astra-Toolaufrufe benötigen Responses. Die folgenden Beispiele beachten diese Grenze und lesen den Schlüssel aus einer Umgebungsvariable, statt ihn im Quellcode abzulegen.

Vor dem Start

Einen begrenzten API-Key erstellen

Melden Sie sich bei OmniaKey an und öffnen Sie die Seite für API-Keys. Erstellen Sie einen eigenen Schlüssel für diese Integration und setzen Sie ein Limit sowie ein Ablaufdatum passend zum Test. Kopieren Sie den Schlüssel, sobald er angezeigt wird.

Das Konto benötigt außerdem verwendbares Guthaben. Die Erstellung des Schlüssels beweist nur, dass die Zugangsdaten existieren, nicht dass das Konto eine Anfrage bezahlen kann.

Behandeln Sie den Schlüssel wie ein Passwort. Committen Sie ihn nicht in Git, legen Sie ihn nicht in einer Browseranwendung ab und zeigen Sie ihn weder in Screenshots noch in Chats.

Den Schlüssel als Umgebungsvariable setzen

Unter macOS oder Linux:

export OMNIAKEY_API_KEY="your-omniakey-api-key"

In PowerShell:

$env:OMNIAKEY_API_KEY="your-omniakey-api-key"

Die folgenden SDK- und Codex-Beispiele lesen dieselbe Variable.

Die erste Responses-API-Anfrage senden

Führen Sie diese Anfrage in einem Terminal aus:

curl https://api.omniakey.com/v1/responses \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning": {"effort": "medium"},
    "input": "Prüfe diesen Migrationsplan. Nenne die zwei größten Risiken und für jedes einen Abnahmetest."
  }'

Eine erfolgreiche Antwort enthält ein output-Array, generierten Text und die Tokennutzung. Dieser erste Aufruf prüft Base URL, Schlüssel, Guthaben, Modellberechtigung, Modell-ID und Responses-Route gemeinsam.

Öffnen Sie anschließend das Nutzungs-Dashboard und bestätigen Sie, dass gpt-6-astra als Modell erfasst wurde. Prüfen Sie tatsächliche Eingabe, gecachte Eingabe, Reasoning und Ausgabe, statt die Kosten nur anhand des sichtbaren Textes zu schätzen.

Astra aus Python aufrufen

Installieren oder aktualisieren Sie das offizielle Python SDK von OpenAI:

python -m pip install --upgrade openai

Erstellen Sie astra_example.py:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OMNIAKEY_API_KEY"],
    base_url="https://api.omniakey.com/v1",
)

response = client.responses.create(
    model="gpt-6-astra",
    reasoning={"effort": "medium"},
    input="Erkläre diesen Incident-Bericht und nenne die drei nützlichsten nächsten Prüfungen.",
)

print(response.output_text)

Führen Sie die Datei aus:

python astra_example.py

response.output_text ist das Komfortfeld des SDK für den generierten Text. Behalten Sie die vollständige Antwort, wenn Sie auch Nutzung, Status oder Toolaufrufe benötigen.

Astra aus Node.js aufrufen

Installieren Sie das SDK:

npm install openai

Erstellen Sie eine serverseitige Datei wie astra-example.mjs:

import OpenAI from "openai";

const apiKey = process.env.OMNIAKEY_API_KEY;
if (!apiKey) throw new Error("OMNIAKEY_API_KEY is required");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.omniakey.com/v1",
});

const response = await client.responses.create({
  model: "gpt-6-astra",
  reasoning: { effort: "medium" },
  input: "Prüfe dieses API-Design. Finde zwei Fehlerszenarien und für jedes einen Test.",
});

console.log(response.output_text);

Starten Sie die Datei aus der Shell, in der die Umgebungsvariable gesetzt ist:

node astra-example.mjs

Führen Sie diesen Code auf einem Server, dem lokalen Rechner oder einem vertrauenswürdigen Worker aus. Ein Schlüssel in einem Frontend-Bundle ist für Besucher zugänglich.

GPT-6 Astra in der Codex CLI verwenden

Ein benutzerdefinierter Codex-Provider verwendet das Responses wire format. Fügen Sie Folgendes zur Benutzerdatei ~/.codex/config.toml hinzu:

model = "gpt-6-astra"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"

Starten Sie Codex aus einer Shell mit gesetztem Schlüssel:

export OMNIAKEY_API_KEY="your-omniakey-api-key"
codex

Lassen Sie requires_openai_auth ungesetzt. Die offizielle Codex-Konfigurationsreferenz definiert diesen Wert als Schalter für die OpenAI-Authentifizierung; der benutzerdefinierte Provider authentifiziert sich stattdessen über env_key.

Prüfen Sie zuerst das in Codex angezeigte Modell und führen Sie eine kleine schreibgeschützte Aufgabe aus, bevor Sie Änderungen erlauben. Wenn ein direkter cURL-Aufruf funktioniert und Codex fehlschlägt, prüfen Sie zunächst die Clientkonfiguration.

Chat Completions nur bei Bedarf des Clients verwenden

GPT-6 Astra akzeptiert normalen Text auch über Chat Completions. Verwenden Sie diese Route, wenn der Client Responses noch nicht unterstützt:

curl https://api.omniakey.com/v1/chat/completions \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning_effort": "medium",
    "messages": [
      {"role": "user", "content": "Fasse die zwei wichtigsten Risiken dieses Rollout-Plans zusammen."}
    ]
  }'

Beachten Sie den Parameterunterschied: Responses verwendet reasoning.effort, Chat Completions dagegen reasoning_effort. Fügen Sie diesem Chat-Completions-Beispiel keine Astra-Tools hinzu. Der aktuelle OpenAI-Leitfaden verlangt Responses für Astra-Toolaufrufe.

Den reasoning effort wählen

Astra unterstützt low, medium, high, xhigh und max, jedoch nicht none. Ein höherer effort kann Reasoning, Latenz und Kosten der Ausgabetoken erhöhen, ohne eine richtige Antwort zu garantieren. Verwenden Sie die niedrigste Einstellung, die Ihren Abnahmetest besteht.

Astra eine prüfbare Aufgabe geben

Ein guter erster Prompt nennt Ziel, relevanten Kontext, Einschränkungen und Abschlussprüfung:

Ziel: das Deploymentrisiko dieser Datenbankmigration prüfen.
Kontext: PostgreSQL 15, ein Writer in Produktion, Rollback muss innerhalb von fünf Minuten enden.
Einschränkungen: keine destruktiven Befehle vorschlagen; bestätigte Fakten von Annahmen trennen.
Fertig, wenn: die drei größten Risiken und für jedes eine Gegenmaßnahme sowie ein Abnahmetest vorliegen.

Nennen Sie bei Codingaufgaben außerdem die Repository-Regeln und den genauen Befehl, der die Fertigstellung beweist. Astra beachtet zugängliche Anweisungsdateien genau. Prüfen Sie daher AGENTS.md, skills und ähnliche Dateien, bevor Sie Toolzugriff gewähren.

Häufige Einrichtungsfehler beheben

401, unauthorized oder ungültiger API-Key

Prüfen Sie, ob OMNIAKEY_API_KEY in derselben Shell gesetzt ist, die den Befehl ausführt. Die Umgebungsvariable enthält nur den Schlüssel; Bearer gehört nur in den HTTP-Header. Prüfen Sie außerdem, ob der Schlüssel aktiviert und nicht abgelaufen ist.

Unzureichendes Guthaben oder Limit

Prüfen Sie sowohl das Kontoguthaben als auch das eigene Limit des Schlüssels. Ein finanziertes Konto kann weiterhin scheitern, wenn der begrenzte Schlüssel sein Limit erreicht hat.

Modell nicht gefunden oder nicht verfügbar

Verwenden Sie die genaue ID gpt-6-astra. Öffnen Sie die aktuelle Modellseite und bestätigen Sie, dass der Schlüssel das Modell verwenden darf. Anzeigenamen wie GPT 6 sind keine API-IDs.

Nicht unterstützter Parameter

Entfernen Sie temperature, top_p und top_logprobs. Entfernen Sie bei Chat Completions auch logprobs und aus include bei Responses den Wert message.output_text.logprobs. Astra unterstützt diese Parameter nicht.

Antwort ist incomplete oder enthält keinen sichtbaren Text

Erhöhen Sie max_output_tokens und prüfen Sie output_tokens_details.reasoning_tokens. Reasoning-Token verbrauchen das Ausgabebudget, bevor die sichtbare Antwort fertig ist.

Chat funktioniert, Tools schlagen fehl

Verschieben Sie den Workflow zu /v1/responses. Testen Sie zuerst eine reine Textanfrage und fügen Sie dann jeweils ein Tool hinzu. Prüfen Sie dabei Anfrage, Ergebnis, Timeout und Berechtigungspfad. Die offizielle OpenAI-Toolliste beschreibt die direkten Modellfunktionen; ein Gateway oder Client kann einen kleineren Umfang bereitstellen.

Codex verwendet weiterhin ein anderes Modell

Prüfen Sie model, model_provider, base_url, env_key und wire_api in der aktiven Codex-Konfiguration. Starten Sie Codex anschließend aus der Shell neu, in der OMNIAKEY_API_KEY gesetzt ist.

Kosten vor der Produktion prüfen

Führen Sie eine repräsentative Aufgabe aus, bestätigen Sie den Nutzungsdatensatz und rechnen Sie Wiederholungen in die Gesamtkosten ein. Die Astra-Modellseite verwaltet den aktuellen OmniaKey-Preis. Der Astra-Test trennt Gatewaypreise von den direkten OpenAI-Tarifen und erklärt deren 272K-Grenze.

Wenn ein Nutzungslimit Ihre Arbeit unterbricht, erklärt der Leitfaden zum Codex-Limit, wie Sie Reset-Zeiten prüfen und Zusatzguthaben, Tarifwechsel oder separat berechnete lokale API-Nutzung vergleichen.

Referenzen

Alle folgenden offiziellen OpenAI-Quellen sind auf Englisch. Auch die OmniaKey-Dokumentationslinks führen derzeit zu englischen Seiten.

• OpenAI: GPT-6-Astra-Modell
• OpenAI: GPT-6 Astra verwenden
• OpenAI: Codex-Konfigurationsreferenz
• OmniaKey API-Schnellstart (auf Englisch)
• OmniaKey OpenAI-kompatible API (auf Englisch)
• OmniaKey Codex-CLI-Leitfaden (auf Englisch)