Persediaan API Astra dengan pengesahan OpenAI rasmi

Mulakan dengan penyedia dan akaun pengebilan

Gunakan gpt-6-astra melalui API OpenAI dengan kunci OpenAI Platform anda sendiri. Untuk aplikasi, mulakan dengan contoh Responses di bawah. Untuk pengekodan tempatan, gunakan arahan log masuk dan pemilihan model CLI Codex. Kedua-dua laluan menggunakan akaun Platform anda dan mengenakan caj API pada kadar OpenAI yang terpakai.

Sebelum menjalankan permintaan, sahkan pemilik projek Platform, sama ada kuncinya boleh mengakses model dan kawalan pengebilan yang terpakai. Model yang muncul dalam ChatGPT atau Codex tidak memberikan akses kepada setiap projek API. Asingkan log masuk langganan dan log masuk kunci API dalam nota run anda. Perbezaan ini penting apabila mendiagnosis had atau merekonsiliasikan caj kemudian.

Sediakan kunci dan klien dalam persekitaran dipercayai

Cipta kunci API dalam papan pemuka OpenAI dan bekalkannya sebagai OPENAI_API_KEY melalui persekitaran peribadi atau pengurus rahsia. SDK rasmi membaca pemboleh ubah itu. Jangan sekali-kali tanam kunci dalam JavaScript pelayar, repositori awam, tangkapan skrin atau transkrip terminal dikongsi. Elakkan jejak shell ketika mengendalikan kelayakan.

Untuk contoh JavaScript di bawah, pasang pakej openai rasmi dalam projek dengan npm install openai. Rekodkan versi dipasang dalam lockfile. baseURL eksplisit memilih OpenAI dan bukannya endpoint tersuai diwarisi. Semak konfigurasi ejen sedia ada juga: penggantian penyedia dan kelayakan daripada perkhidmatan lain tidak menjadi serasi hanya kerana kedua-duanya menerima pengepala Authorization.

Hantar permintaan Responses dan baca jawapan

Cipta astra-example.mjs dengan kod berikut, kemudian jalankan node astra-example.mjs. Prompt meminta senarai semak pendek supaya anda boleh memeriksa jawapan yang dikembalikan sebelum menyambungkan aliran kerja lebih besar. Percubaan semula SDK automatik dinyahdayakan untuk permintaan pertama ini, menjadikan ralat sambungan atau akaun lebih mudah didiagnosis.

Apabila status ialah completed, response.output_text mengandungi output teks gabungan SDK. Cetak ke output standard supaya program lain boleh menggunakannya atau mengalihkannya ke fail. Hantar metadata respons ke ralat standard supaya terpisah daripada jawapan. Untuk respons tidak lengkap, kekalkan incomplete_details dan usage serta pulangkan kod keluar bukan sifar.

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
}

Pilih pengesahan kunci API untuk Codex tempatan

OpenAI mendokumenkan log masuk kunci API untuk kerja Codex tempatan. Dalam CLI, periksa codex login status sebelum menukar kelayakan. Arahan stdin yang didokumenkan di bawah mengelakkan rahsia ditampal ke dalam hujah perintah. Selepas log masuk, semak kaedah pengesahan aktif sekali lagi, kemudian pilih model tepat dengan flag model CLI.

Perintah terakhir membuka sesi interaktif dengan Astra dipilih. Mulakan dalam direktori projek supaya ejen boleh membaca fail dan arahan repositori yang betul. Semak penggantian penyedia sedia ada dan sahkan akaun aktif. Mod kunci API menyokong kerja tempatan; Codex cloud memerlukan pengesahan ChatGPT. Untuk tugas cloud yang hendak diteruskan secara tempatan, bawa fail kerja dan ringkasan ringkas kerja berbaki ke projek tempatan terlebih dahulu.

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

Padankan keupayaan dengan laluan klien

Astra menyokong Responses dan Chat Completions, tetapi panggilan alat memerlukan Responses. Gunakan Responses untuk ejen yang melaksanakan fungsi atau alat tersuai. Klien yang ditulis untuk membaca pilihan chat tidak boleh menghurai output Responses hanya dengan menukar URL, dan smoke test teks tidak menguji gelung alat.

Tambah satu keupayaan pada satu masa menggunakan contoh kecil aplikasi. Untuk alat, sahkan hujah, jalankan fungsi dalam aplikasi dan pulangkan hasil melalui Responses dengan call_id yang sepadan. Untuk output berstruktur, sahkan skema dan kendalikan respons tidak lengkap. Untuk penstriman, proses peristiwa selesai dan pembatalan serta teks. Kekalkan permintaan teks mudah sebagai laluan diagnosis semasa menambah ciri ini.

Diagnosis kegagalan akses, kadar dan penyelesaian secara berasingan

Gunakan status HTTP dan medan ralat berstruktur sebelum mencuba semula. Panduan ralat OpenAI membezakan pengesahan tidak sah, kredit habis, had perbelanjaan dikuatkuasakan dan tekanan kadar permintaan. Khususnya, respons 429 tidak mencukupi untuk memilih pembaikan: periksa error.code dan tetapan akaun berkaitan.

Untuk tekanan kadar sementara, hormati Retry-After apabila ada dan gunakan percubaan semula terhad. Kegagalan pengebilan atau had perbelanjaan memerlukan keputusan akaun, bukan permintaan berulang. Hasil Responses yang ditanda incomplete ialah keadaan berbeza dan mungkin sudah menggunakan token. Simpan maklumat ralat yang disunting dan penggunaan; jangan ubah tamat masa atau resit hilang menjadi percubaan berjaya atau percuma.

Ketersediaan penyedia dan bukti: 5 September 2026

OpenAI telah mengumumkan GPT-6 Astra dengan pelancaran berperingkat dan rujukan modelnya mendokumenkan API rasmi. Contoh di sini mengikuti sumber itu; tiada permintaan berbayar atau pertukaran pengesahan Codex dijalankan untuk panduan ini. Pemeriksaan katalog awam APIsRouter pada 5 September 2026 mengembalikan HTTP 200, success: true dan 34 model, tanpa entri Astra atau GPT-6.

Gunakan kelayakan OpenAI hanya dengan endpoint rasmi di atas. Semak katalog APIsRouter langsung untuk tawarannya sendiri. Penyenaraian Astra kemudian masih memerlukan ID model tepat, harga dan ciri klien yang diperlukan diperiksa sebelum digunakan dalam aplikasi.

Sambungkan respons kepada aliran kerja tempatan yang berguna

Pilih satu tugas tempatan dengan hasil konkrit, seperti menerangkan fungsi dan mencadangkan ujian. Berikan ejen laluan fail berkaitan, tingkah laku dijangka dan arahan ujian. Selepas perubahan kod, periksa diff dan jalankan ujian terfokus. Simpan input asal dan jawapan yang dipulangkan bersama supaya semakan mudah dibandingkan.

Dalam aplikasi, hantar teks selesai ke skrin semakan atau saluran dokumen. Jika langkah seterusnya menjangka data boleh dibaca mesin, gunakan output berstruktur dan sahkan medan wajib sebelum menyimpannya. Simpan identiti permintaan dan penggunaan bersama tugas serta tetapkan dasar percubaan terhad. Luaskan aliran kerja selepas input asas, pengendalian respons dan pemeriksaan selesai berfungsi bersama.

Soalan lazim