Astra API instellen met officiële OpenAI-authenticatie

Begin met provider en factureringsaccount

Gebruik gpt-6-astra via de API van OpenAI met je eigen OpenAI Platform-key. Gebruik voor een applicatie het Responses-voorbeeld hieronder als startpunt. Gebruik voor lokaal codewerk de Codex CLI-aanmeld- en modelselectieopdrachten. Beide paden gebruiken je Platform-account en brengen API-kosten tegen de toepasselijke OpenAI-tarieven met zich mee.

Controleer voordat je een request uitvoert wie eigenaar is van het Platform-project, of de key toegang heeft tot het model en welke factureringscontroles gelden. Dat een model in ChatGPT of Codex verschijnt, geeft niet elk API-project toegang. Houd abonnementslogin en API-key-login afzonderlijk bij in je runnotities. Dat onderscheid is essentieel bij het onderzoeken van een limiet of het later afstemmen van kosten.

Bereid key en client voor in een vertrouwde omgeving

Maak een API-key aan in het OpenAI-dashboard en lever die als OPENAI_API_KEY aan via je private omgeving of secretmanager. De officiële SDK leest die variabele. Neem de key nooit op in browser-JavaScript, een openbare repository, een screenshot of een gedeeld terminaltranscript. Vermijd shell tracing bij het verwerken van credentials.

Installeer voor het JavaScript-voorbeeld hieronder het officiële openai-pakket in je project met npm install openai. Leg de geïnstalleerde versie vast in je lockfile. De expliciete baseURL selecteert OpenAI in plaats van een overgenomen aangepast endpoint. Controleer ook bestaande agentconfiguratie: een provider override en een credential van een andere service worden niet compatibel alleen omdat beide een Authorization-header accepteren.

Verstuur een Responses-request en lees het antwoord

Maak astra-example.mjs met de volgende code en voer daarna node astra-example.mjs uit. De prompt vraagt om een korte checklist, zodat je het geretourneerde antwoord kunt inspecteren voordat je een grotere workflow koppelt. Automatische SDK-retries zijn voor deze eerste request uitgeschakeld, waardoor verbindings- of accountfouten eenvoudiger te diagnosticeren zijn.

Wanneer status completed is, bevat response.output_text de gecombineerde tekstuitvoer van de SDK. Print die naar standard output zodat een ander programma hem kan gebruiken of naar een bestand kan omleiden. Stuur response-metadata naar standard error om die van het antwoord gescheiden te houden. Bewaar voor incomplete responses incomplete_details en usage en geef een exitcode ongelijk aan nul terug.

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
}

Kies API-key-authenticatie voor lokale Codex

OpenAI documenteert API-key-login voor lokaal Codex-werk. Controleer in de CLI codex login status voordat je credentials wijzigt. De gedocumenteerde stdin-opdracht hieronder voorkomt dat je een secret in een commandargument plakt. Controleer na het inloggen opnieuw de actieve authenticatiemethode en selecteer daarna het exacte model met de CLI-modelvlag.

De laatste opdracht opent een interactieve sessie met Astra geselecteerd. Start in je projectdirectory zodat de agent de juiste bestanden en repository-instructies kan lezen. Controleer bestaande provider overrides en bevestig het actieve account. API-key-modus ondersteunt lokaal werk; Codex cloud vereist ChatGPT-authenticatie. Bereid voor een cloudtaak die je lokaal wilt voortzetten eerst de werkbestanden en een korte samenvatting van het resterende werk in je lokale project voor.

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

Stem mogelijkheden af op het clientpad

Astra ondersteunt Responses en Chat Completions, maar tool calling vereist Responses. Gebruik Responses voor een agent die functies of aangepaste tools uitvoert. Een client die chat choices leest, kan Responses-output niet verwerken door alleen de URL te wijzigen; een text-only smoke test voert bovendien geen tool-loop uit.

Voeg telkens één mogelijkheid toe met een klein voorbeeld uit je applicatie. Valideer voor tools de argumenten, voer de functie in je applicatie uit en retourneer het resultaat via Responses met de overeenkomende call_id. Valideer bij structured output het schema en verwerk incomplete responses. Verwerk bij streaming zowel completion- als cancellation-events naast tekst. Houd de eenvoudige text request beschikbaar als diagnosepad terwijl je deze functies toevoegt.

Diagnosticeer toegangs-, rate- en completionfouten afzonderlijk

Gebruik HTTP-status en gestructureerde errorvelden voordat je opnieuw probeert. De foutengids van OpenAI onderscheidt ongeldige authenticatie, uitgeputte credits, afgedwongen spend limits en request-rate-druk. Een 429-respons is op zichzelf niet genoeg om een oplossing te kiezen: inspecteer error.code en de relevante accountinstellingen.

Respecteer bij tijdelijke rate-druk Retry-After wanneer dat aanwezig is en gebruik begrensde retries. Facturerings- of spend-limit-fouten vragen om een accountbeslissing, niet om herhaalde requests. Een Responses-resultaat met status incomplete is opnieuw een andere conditie en kan al tokens hebben verbruikt. Bewaar geredigeerde foutinformatie en usage; maak van een timeout of ontbrekend ontvangstbewijs geen geslaagde of gratis poging.

Beschikbaarheid van de provider en bewijs: 5 september 2026

OpenAI heeft GPT-6 Astra aangekondigd met een gefaseerde uitrol en de modelreferentie documenteert de officiële API. De voorbeelden hier volgen die bronnen; voor dit artikel is geen betaalde request en geen Codex-authenticatiewissel uitgevoerd. De openbare APIsRouter-prijscontrole op 5 september 2026 gaf HTTP 200, success: true en 34 modellen terug, zonder Astra- of GPT-6-vermelding.

Gebruik OpenAI-credentials alleen met het hierboven getoonde officiële endpoint. Controleer de live APIsRouter-catalogus voor het eigen aanbod. Een latere Astra-vermelding vereist nog steeds controle van de exacte model-ID, prijs en benodigde clientfuncties voordat je die in je applicatie gebruikt.

Verbind de response met een nuttige lokale workflow

Kies één lokale taak met een concreet resultaat, zoals een functie uitleggen en een test voorstellen. Geef de agent het relevante bestandspad, verwacht gedrag en testcommando. Inspecteer na een codewijziging de diff en voer de gerichte tests uit. Bewaar oorspronkelijke input en geretourneerd antwoord samen zodat revisies eenvoudig te vergelijken zijn.

Geef in een applicatie voltooide tekst door aan je reviewscherm of documentpipeline. Als de volgende stap machineleesbare data verwacht, gebruik structured output en valideer verplichte velden voordat je die opslaat. Houd requestidentiteit en usage naast de taak bij en stel een begrensd retrybeleid in. Breid de workflow pas uit wanneer basisinvoer, responseafhandeling en completioncontroles samen werken.

Veelgestelde vragen