Astra-API-Einrichtung mit offizieller OpenAI-Authentifizierung

Beginnen Sie mit Anbieter und Abrechnungskonto

Verwenden Sie gpt-6-astra über die OpenAI-API mit Ihrem eigenen OpenAI-Platform-Schlüssel. Beginnen Sie für eine Anwendung mit dem folgenden Responses-Beispiel. Für lokale Programmierarbeit verwenden Sie die Codex-CLI-Befehle zum Anmelden und zur Modellauswahl. Beide Wege nutzen Ihr Platform-Konto und verursachen API-Gebühren zu den geltenden OpenAI-Tarifen.

Bestätigen Sie vor einer Anfrage, wem das Platform-Projekt gehört, ob sein Schlüssel auf das Modell zugreifen kann und welche Abrechnungskontrollen gelten. Ein Modell, das in ChatGPT oder Codex erscheint, gewährt keinen Zugriff auf jedes API-Projekt. Halten Sie Abonnement-Login und API-Key-Login in Ihren Laufnotizen getrennt. Diese Unterscheidung ist entscheidend, wenn Sie später ein Limit diagnostizieren oder Gebühren abgleichen.

Bereiten Sie Schlüssel und Client in einer vertrauenswürdigen Umgebung vor

Erstellen Sie im OpenAI-Dashboard einen API-Schlüssel und stellen Sie ihn über Ihre private Umgebung oder einen Secret-Manager als OPENAI_API_KEY bereit. Das offizielle SDK liest diese Variable. Betten Sie den Schlüssel niemals in Browser-JavaScript, ein öffentliches Repository, einen Screenshot oder ein geteiltes Terminalprotokoll ein. Vermeiden Sie beim Umgang mit Zugangsdaten Shell-Trace-Ausgaben.

Installieren Sie für das folgende JavaScript-Beispiel das offizielle openai-Paket mit npm install openai in Ihrem Projekt. Erfassen Sie die installierte Version in Ihrer Lockdatei. Die ausdrückliche baseURL wählt OpenAI statt eines geerbten benutzerdefinierten Endpunkts. Prüfen Sie auch die bestehende Agentenkonfiguration: Eine Anbieterüberschreibung und eine Zugangsdatenquelle eines anderen Dienstes werden nicht allein dadurch kompatibel, dass beide einen Authorization-Header akzeptieren.

Senden Sie eine Responses-Anfrage und lesen Sie die Antwort

Erstellen Sie astra-example.mjs mit dem folgenden Code und führen Sie anschließend node astra-example.mjs aus. Der Prompt bittet um eine kurze Checkliste, damit Sie die zurückgegebene Antwort prüfen können, bevor Sie einen größeren Workflow anschließen. Automatische SDK-Wiederholungen sind für diese erste Anfrage deaktiviert, wodurch Verbindungs- oder Kontofehler leichter zu diagnostizieren sind.

Wenn status completed ist, enthält response.output_text die kombinierte Textausgabe des SDK. Geben Sie sie auf der Standardausgabe aus, damit ein anderes Programm sie verarbeiten oder in eine Datei umleiten kann. Senden Sie Antwortmetadaten an die Standardfehlerausgabe, damit sie von der Antwort getrennt bleiben. Bei unvollständigen Antworten bewahren Sie incomplete_details und usage auf und geben Sie einen Exit-Code ungleich null zurück.

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.openai.com/v1',
  maxRetries: 0,
})
const response = await client.responses.create({
  model: 'gpt-6-astra',
  input: 'List three checks for a small code change.',
})
console.error(JSON.stringify({
  id: response.id,
  model: response.model,
  status: response.status,
  usage: response.usage,
  incomplete_details: response.incomplete_details,
}))
if (response.status === 'completed') {
  console.log(response.output_text)
} else {
  process.exitCode = 1
}

Wählen Sie API-Key-Authentifizierung für lokales Codex

OpenAI dokumentiert die Anmeldung per API-Key für lokale Codex-Arbeit. Prüfen Sie in der CLI den Status mit codex login status, bevor Sie Zugangsdaten ändern. Der unten dokumentierte stdin-Befehl verhindert, dass ein Geheimnis in ein Kommandoargument eingefügt wird. Prüfen Sie nach der Anmeldung die aktive Authentifizierungsmethode erneut und wählen Sie anschließend mit dem CLI-Modellflag das exakte Modell.

Der letzte Befehl öffnet eine interaktive Sitzung mit ausgewähltem Astra. Starten Sie im Projektverzeichnis, damit der Agent die richtigen Dateien und Repository-Anweisungen lesen kann. Prüfen Sie bestehende Anbieterüberschreibungen und bestätigen Sie das aktive Konto. Der API-Key-Modus unterstützt lokale Arbeit; Codex Cloud benötigt ChatGPT-Authentifizierung. Wenn Sie eine Cloud-Aufgabe lokal fortsetzen möchten, bringen Sie zuerst die Arbeitsdateien und eine kurze Zusammenfassung der offenen Arbeit in Ihr lokales Projekt.

codex login status
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status
codex --model gpt-6-astra

Passen Sie Fähigkeiten an den Clientpfad an

Astra unterstützt Responses und Chat Completions, aber Tool-Aufrufe erfordern Responses. Verwenden Sie Responses für einen Agenten, der Funktionen oder benutzerdefinierte Tools ausführt. Ein Client, der Chat-Choices lesen soll, kann Responses-Ausgabe nicht allein durch eine URL-Änderung parsen, und ein Nur-Text-Smoke-Test übt keine Tool-Schleife aus.

Fügen Sie jeweils nur eine Fähigkeit hinzu und verwenden Sie dafür ein kleines Beispiel aus Ihrer Anwendung. Validieren Sie bei Tools die Argumente, führen Sie die Funktion in Ihrer Anwendung aus und geben Sie das Ergebnis über Responses mit der passenden call_id zurück. Validieren Sie bei strukturierter Ausgabe das Schema und behandeln Sie unvollständige Antworten. Verarbeiten Sie beim Streaming neben Text auch Abschluss- und Abbruchereignisse. Halten Sie die einfache Textanfrage als Diagnosepfad verfügbar, während Sie diese Funktionen hinzufügen.

Diagnostizieren Sie Zugriffs-, Raten- und Abschlussfehler getrennt

Verwenden Sie vor einer Wiederholung den HTTP-Status und strukturierte Fehlerfelder. Der OpenAI-Fehlerleitfaden unterscheidet ungültige Authentifizierung, erschöpfte Credits, durchgesetzte Ausgabenlimits und Anfrageratendruck. Insbesondere reicht eine 429-Antwort nicht aus, um eine Maßnahme auszuwählen: Prüfen Sie error.code und die relevanten Kontoeinstellungen.

Beachten Sie bei vorübergehendem Ratendruck Retry-After, wenn vorhanden, und verwenden Sie begrenzte Wiederholungen. Abrechnungs- oder Ausgabenlimitfehler benötigen eine Kontoentscheidung und keine wiederholten Anfragen. Ein als incomplete markiertes Responses-Ergebnis ist wiederum ein anderer Zustand und kann bereits Tokens verbraucht haben. Bewahren Sie bereinigte Fehlerinformationen und Nutzung auf; machen Sie aus einem Timeout oder einem fehlenden Beleg keinen erfolgreichen oder kostenlosen Versuch.

Verfügbarkeit des Anbieters und Belege: 5. September 2026

OpenAI hat GPT-6 Astra mit stufenweiser Einführung angekündigt, und seine Modellreferenz dokumentiert die offizielle API. Die Beispiele hier folgen diesen Quellen; für diesen Leitfaden wurde weder eine kostenpflichtige Anfrage noch ein Wechsel der Codex-Authentifizierung ausgeführt. Die öffentliche APIsRouter-Katalogprüfung am 5. September 2026 gab HTTP 200, success: true und 34 Modelle ohne Astra- oder GPT-6-Eintrag zurück.

Verwenden Sie OpenAI-Zugangsdaten ausschließlich mit dem oben gezeigten offiziellen Endpunkt. Prüfen Sie den Live-APIsRouter-Katalog für seine eigenen Angebote. Ein späterer Astra-Eintrag müsste weiterhin auf exakte Modell-ID, Preis und erforderliche Clientfunktionen geprüft werden, bevor Sie ihn in Ihrer Anwendung verwenden.

Verbinden Sie die Antwort mit einem nützlichen lokalen Workflow

Wählen Sie eine lokale Aufgabe mit einem konkreten Ergebnis, etwa die Erklärung einer Funktion und den Vorschlag eines Tests. Geben Sie dem Agenten relevanten Dateipfad, erwartetes Verhalten und Testbefehl. Prüfen Sie nach einer Codeänderung den Diff und führen Sie die fokussierten Tests aus. Bewahren Sie ursprüngliche Eingabe und zurückgegebene Antwort gemeinsam auf, damit Revisionen leicht verglichen werden können.

Übergeben Sie in einer Anwendung abgeschlossenen Text an Ihre Prüfoberfläche oder Dokumentpipeline. Wenn der nächste Schritt maschinenlesbare Daten erwartet, verwenden Sie strukturierte Ausgabe und validieren Sie erforderliche Felder vor dem Speichern. Bewahren Sie Anfrageidentität und Nutzung neben der Aufgabe auf und legen Sie eine begrenzte Wiederholungsrichtlinie fest. Erweitern Sie den Workflow, nachdem grundlegende Eingabe, Antwortverarbeitung und Abschlussprüfungen gemeinsam funktionieren.

Häufige Fragen