Setup API Astra dengan autentikasi OpenAI resmi

Mulai dari penyedia dan akun penagihan

Gunakan gpt-6-astra melalui API OpenAI dengan key OpenAI Platform milik Anda. Untuk aplikasi, mulai dari contoh Responses di bawah. Untuk coding lokal, gunakan perintah login dan pemilihan model Codex CLI. Kedua jalur menggunakan akun Platform Anda dan menimbulkan biaya API sesuai tarif OpenAI yang berlaku.

Sebelum menjalankan permintaan, pastikan siapa pemilik project Platform, apakah key dapat mengakses model, dan kontrol penagihan apa yang berlaku. Model yang muncul di ChatGPT atau Codex tidak memberikan akses ke setiap project API. Pisahkan login langganan dan login API key dalam catatan run. Pembedaan ini penting saat mendiagnosis batas atau merekonsiliasi biaya nantinya.

Siapkan key dan client di lingkungan tepercaya

Buat API key di dashboard OpenAI dan berikan sebagai OPENAI_API_KEY melalui environment privat atau secret manager. SDK resmi membaca variabel tersebut. Jangan menanamkan key dalam JavaScript browser, repositori publik, screenshot, atau transkrip terminal bersama. Hindari shell tracing saat menangani kredensial.

Untuk contoh JavaScript di bawah, instal paket openai resmi dalam project Anda dengan npm install openai. Catat versi terinstal di lockfile. baseURL eksplisit memilih OpenAI, bukan endpoint khusus yang diwarisi. Tinjau konfigurasi agen yang ada juga: override penyedia dan kredensial dari layanan lain tidak menjadi kompatibel hanya karena keduanya menerima header Authorization.

Kirim permintaan Responses dan baca jawabannya

Buat astra-example.mjs dengan kode berikut, kemudian jalankan node astra-example.mjs. Prompt meminta checklist singkat agar Anda dapat memeriksa jawaban yang dikembalikan sebelum menghubungkan alur yang lebih besar. Retry otomatis SDK dinonaktifkan untuk permintaan pertama ini, sehingga error koneksi atau akun lebih mudah didiagnosis.

Saat status adalah completed, response.output_text berisi gabungan output teks SDK. Cetak ke standard output agar program lain dapat mengonsumsinya atau mengarahkannya ke file. Kirim metadata response ke standard error agar terpisah dari jawaban. Untuk response yang tidak lengkap, pertahankan incomplete_details dan usage lalu kembalikan exit code nonzero.

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 autentikasi API key untuk Codex lokal

OpenAI mendokumentasikan login API key untuk pekerjaan Codex lokal. Di CLI, periksa status login codex sebelum mengubah kredensial. Perintah stdin terdokumentasi di bawah menghindari penempelan secret ke argumen perintah. Setelah login, periksa lagi metode autentikasi aktif, lalu pilih model persis dengan flag model CLI.

Perintah terakhir membuka sesi interaktif dengan Astra terpilih. Mulai di direktori project agar agen dapat membaca file dan instruksi repositori yang tepat. Tinjau override penyedia yang ada dan konfirmasi akun aktif. Mode API key mendukung pekerjaan lokal; Codex cloud memerlukan autentikasi ChatGPT. Untuk tugas cloud yang ingin dilanjutkan secara lokal, bawa file kerja dan ringkasan singkat pekerjaan tersisa ke project lokal terlebih dahulu.

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

Cocokkan kapabilitas dengan jalur client

Astra mendukung Responses dan Chat Completions, tetapi tool calling memerlukan Responses. Gunakan Responses untuk agen yang menjalankan fungsi atau custom tool. Client yang ditulis untuk membaca chat choices tidak dapat mengurai output Responses hanya dengan mengubah URL, dan smoke text-only tidak menguji loop tool.

Tambahkan satu kapabilitas pada satu waktu menggunakan contoh kecil dari aplikasi Anda. Untuk tools, validasi argumen, jalankan fungsi di aplikasi Anda, dan kembalikan hasil melalui Responses dengan call_id yang cocok. Untuk output terstruktur, validasi schema dan tangani response yang tidak lengkap. Untuk streaming, proses event penyelesaian dan pembatalan serta teks. Sediakan permintaan teks sederhana sebagai jalur diagnosis sambil menambahkan fitur tersebut.

Diagnosis kegagalan akses, rate, dan penyelesaian secara terpisah

Gunakan status HTTP dan kolom error terstruktur sebelum mencoba ulang. Panduan error OpenAI membedakan autentikasi tidak valid, kredit habis, batas pengeluaran yang ditegakkan, dan tekanan laju permintaan. Secara khusus, response 429 saja tidak cukup untuk memilih perbaikan: periksa error.code dan pengaturan akun yang relevan.

Untuk tekanan rate sementara, hormati Retry-After bila ada dan gunakan retry terbatas. Kegagalan billing atau batas pengeluaran memerlukan keputusan akun, bukan permintaan berulang. Hasil Responses berstatus incomplete adalah kondisi lain dan token mungkin sudah terpakai. Simpan informasi error yang sudah disamarkan dan usage; jangan mengubah timeout atau tanda terima yang hilang menjadi percobaan sukses atau gratis.

Ketersediaan penyedia dan bukti: 5 September 2026

OpenAI telah mengumumkan GPT-6 Astra dengan peluncuran bertahap, dan referensi modelnya mendokumentasikan API resmi. Contoh di sini mengikuti sumber tersebut; tidak ada permintaan berbayar atau perubahan autentikasi Codex yang dijalankan untuk panduan ini. Pemeriksaan katalog publik APIsRouter pada 5 September 2026 mengembalikan HTTP 200, success: true, dan 34 model, tanpa entri Astra atau GPT-6.

Gunakan kredensial OpenAI hanya dengan endpoint resmi di atas. Periksa katalog APIsRouter live untuk penawarannya sendiri. Jika Astra tercantum kemudian, tetap periksa model ID, harga, dan fitur client yang diperlukan sebelum menggunakannya dalam aplikasi.

Hubungkan response dengan alur kerja lokal yang berguna

Pilih satu tugas lokal dengan hasil konkret, seperti menjelaskan fungsi dan mengusulkan tes. Berikan agen path file yang relevan, perilaku yang diharapkan, dan perintah test. Setelah perubahan kode, periksa diff dan jalankan focused test. Simpan input asli dan jawaban yang dikembalikan bersama agar revisi mudah dibandingkan.

Dalam aplikasi, teruskan teks yang selesai ke layar peninjauan atau pipeline dokumen. Jika langkah berikutnya mengharapkan data yang dapat dibaca mesin, gunakan output terstruktur dan validasi kolom yang diperlukan sebelum menyimpannya. Simpan identitas request dan usage bersama task, serta tetapkan kebijakan retry terbatas. Perluas alur setelah input dasar, penanganan response, dan pemeriksaan penyelesaian bekerja bersama.

Pertanyaan umum