Astra API setup gamit ang opisyal na OpenAI authentication

Magsimula sa provider at billing account

Gamitin ang gpt-6-astra sa pamamagitan ng API ng OpenAI gamit ang sarili mong OpenAI Platform key. Para sa application, magsimula sa Responses example sa ibaba. Para sa lokal na coding work, gamitin ang Codex CLI login at model-selection command. Parehong gumagamit ang mga path ng Platform account mo at nagkakaroon ng API charge sa naaangkop na OpenAI rate.

Bago magpatakbo ng request, kumpirmahin kung sino ang may-ari ng Platform project, kung maa-access ng key nito ang model, at aling billing control ang naaangkop. Hindi nagbibigay ng access sa bawat API project ang paglitaw ng model sa ChatGPT o Codex. Panatilihing hiwalay sa run note ang subscription login at API-key login. Mahalaga ang pagkakaibang ito kapag nag-diagnose ng limit o nagre-reconcile ng charge sa susunod.

Ihanda ang key at client sa pinagkakatiwalaang environment

Gumawa ng API key sa OpenAI dashboard at ibigay ito bilang OPENAI_API_KEY sa pamamagitan ng pribadong environment o secret manager. Binabasa ng opisyal na SDK ang variable na iyon. Huwag kailanman i-embed ang key sa browser JavaScript, public repository, screenshot, o shared terminal transcript. Iwasan ang shell tracing habang hinahawakan ang credential.

Para sa JavaScript example sa ibaba, i-install ang opisyal na openai package sa project gamit ang npm install openai. Itala ang naka-install na bersyon sa lockfile. Pinipili ng tahasang baseURL ang OpenAI sa halip na minanang custom endpoint. Suriin din ang kasalukuyang agent configuration: hindi nagiging compatible ang provider override at credential mula sa ibang service dahil lamang parehong tumatanggap ng Authorization header.

Magpadala ng Responses request at basahin ang sagot

Gumawa ng astra-example.mjs gamit ang sumusunod na code, saka patakbuhin ang node astra-example.mjs. Humihingi ang prompt ng maikling checklist upang masuri mo ang ibinalik na sagot bago ikonekta ang mas malaking workflow. Naka-disable ang automatic SDK retry para sa unang request na ito, kaya mas madaling i-diagnose ang connection o account error.

Kapag completed ang status, naglalaman ang response.output_text ng pinagsamang text output ng SDK. I-print ito sa standard output upang magamit ito ng ibang program o mai-redirect sa file. Ipadala ang response metadata sa standard error upang manatili itong hiwalay sa sagot. Para sa incomplete response, panatilihin ang incomplete_details at usage at magbalik ng nonzero exit code.

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
}

Piliin ang API-key authentication para sa lokal na Codex

Dinudokumento ng OpenAI ang API-key login para sa lokal na Codex work. Sa CLI, suriin ang codex login status bago baguhin ang credential. Iniiwasan ng documented stdin command sa ibaba ang pag-paste ng secret sa command argument. Pagkatapos mag-login, suriin muli ang aktibong authentication method, saka piliin ang eksaktong model gamit ang CLI model flag.

Binubuksan ng huling command ang interactive session na napili ang Astra. Magsimula sa project directory upang mabasa ng agent ang tamang file at repository instruction. Suriin ang kasalukuyang provider override at kumpirmahin ang aktibong account. Sinusuportahan ng API-key mode ang lokal na work; nangangailangan ang Codex cloud ng ChatGPT authentication. Para sa cloud task na nais mong ipagpatuloy nang lokal, dalhin muna sa lokal na project ang working file at maikling buod ng natitirang trabaho.

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

Itugma ang capability sa client path

Sinusuportahan ng Astra ang Responses at Chat Completions, ngunit nangangailangan ng Responses ang tool calling. Gamitin ang Responses para sa agent na nagpapatakbo ng function o custom tool. Hindi kayang i-parse ng client na nakasulat para magbasa ng chat choice ang Responses output sa pamamagitan lamang ng pagpapalit ng URL, at hindi nasusubok ng text-only smoke ang tool loop.

Magdagdag ng isang capability bawat pagkakataon gamit ang maliit na example mula sa application mo. Para sa tool, i-validate ang argument, patakbuhin ang function sa application, at ibalik ang resulta sa pamamagitan ng Responses gamit ang katugmang call_id. Para sa structured output, i-validate ang schema at hawakan ang incomplete response. Para sa streaming, iproseso ang completion at cancellation event pati text. Panatilihing available ang simpleng text request bilang diagnostic path habang idinaragdag ang mga feature na ito.

Hiwalay na i-diagnose ang access, rate, at completion failure

Gamitin ang HTTP status at structured error field bago mag-retry. Pinaghihiwalay ng error guide ng OpenAI ang invalid authentication, naubos na credit, enforced spend limit, at request-rate pressure. Lalo na, hindi sapat ang 429 response para pumili ng remedy: suriin ang error.code at kaugnay na account setting.

Para sa pansamantalang rate pressure, igalang ang Retry-After kapag naroon at gumamit ng limitadong retry. Kailangan ng billing o spend-limit failure ng desisyon sa account, hindi paulit-ulit na request. Ibang kondisyon ang Responses result na may markang incomplete at maaaring nakonsumo na ito ng token. Panatilihin ang redacted error information at usage; huwag gawing matagumpay o libreng attempt ang timeout o nawawalang receipt.

Availability at ebidensya ng provider: September 5, 2026

Inanunsyo ng OpenAI ang GPT-6 Astra na may staged rollout, at inilalarawan ng model reference nito ang opisyal na API. Sinusunod ng mga example dito ang mga source na iyon; walang paid request o Codex authentication switch na isinagawa para sa guide na ito. Ang public APIsRouter catalog check noong September 5, 2026 ay nagbalik ng HTTP 200, success: true, at 34 model, na walang Astra o GPT-6 entry.

Gamitin lamang ang OpenAI credential sa opisyal na endpoint na ipinakita sa itaas. Suriin ang live APIsRouter catalog para sa sarili nitong offering. Kailangan pa ring suriin ang eksaktong model ID, presyo, at kinakailangang client feature ng anumang Astra listing sa hinaharap bago ito gamitin sa application mo.

Ikonekta ang response sa kapaki-pakinabang na lokal na workflow

Pumili ng isang lokal na task na may konkretong resulta, gaya ng pagpapaliwanag sa isang function at pagmumungkahi ng test. Ibigay sa agent ang kaugnay na file path, inaasahang behavior, at test command. Pagkatapos ng code change, siyasatin ang diff at patakbuhin ang focused test. Panatilihing magkasama ang orihinal na input at ibinalik na sagot upang madaling maihambing ang revision.

Sa application, ipasa ang nakumpletong text sa review screen o document pipeline. Kung machine-readable data ang inaasahan ng susunod na hakbang, gumamit ng structured output at i-validate ang kinakailangang field bago i-store. Itabi ang request identity at usage sa task, at magtakda ng limitadong retry policy. Palawakin ang workflow kapag gumagana nang magkakasama ang basic input, response handling, at completion check.

Mga madalas itanong