ตั้งค่า Astra API ด้วยการยืนยันตัวตน OpenAI อย่างเป็นทางการ

เริ่มจากผู้ให้บริการและบัญชีเรียกเก็บเงิน

ใช้ gpt-6-astra ผ่าน API ของ OpenAI ด้วยคีย์ OpenAI Platform ของคุณเอง สำหรับแอปพลิเคชัน ให้เริ่มจากตัวอย่าง Responses ด้านล่าง สำหรับงานเขียนโค้ดภายในเครื่อง ให้ใช้คำสั่งเข้าสู่ระบบและเลือกโมเดลของ Codex CLI ทั้งสองเส้นทางใช้บัญชี Platform ของคุณและมีค่าใช้จ่าย API ตามราคา OpenAI ที่ใช้บังคับ

ก่อนรันคำขอ ให้ยืนยันว่าใครเป็นเจ้าของโปรเจกต์ Platform คีย์นั้นเข้าถึงโมเดลได้หรือไม่ และใช้การควบคุมการเรียกเก็บเงินใด โมเดลที่ปรากฏใน ChatGPT หรือ Codex ไม่ได้ให้สิทธิ์เข้าถึงทุกโปรเจกต์ API แยกการเข้าสู่ระบบ subscription และคีย์ API ในบันทึกงาน ความแตกต่างนี้สำคัญเมื่อวินิจฉัยขีดจำกัดหรือกระทบยอดค่าใช้จ่ายภายหลัง

เตรียมคีย์และไคลเอนต์ในสภาพแวดล้อมที่เชื่อถือได้

สร้างคีย์ API ในแดชบอร์ด OpenAI และส่งเป็น OPENAI_API_KEY ผ่านสภาพแวดล้อมส่วนตัวหรือ secret manager SDK อย่างเป็นทางการจะอ่านตัวแปรนี้ อย่าใส่คีย์ไว้ใน JavaScript ของเบราว์เซอร์ รีโพสาธารณะ ภาพหน้าจอ หรือบันทึกเทอร์มินัลที่แชร์ หลีกเลี่ยงการเปิด shell tracing ขณะจัดการข้อมูลรับรอง

สำหรับตัวอย่าง JavaScript ด้านล่าง ให้ติดตั้งแพ็กเกจ openai อย่างเป็นทางการในโปรเจกต์ด้วย npm install openai บันทึกเวอร์ชันที่ติดตั้งไว้ใน lockfile การกำหนด baseURL อย่างชัดเจนจะเลือก OpenAI แทน endpoint แบบกำหนดเองที่สืบทอดมา ตรวจสอบการตั้งค่าเอเจนต์ที่มีอยู่ด้วย เพราะการ override ผู้ให้บริการและข้อมูลรับรองจากบริการอื่นไม่ได้กลายเป็นสิ่งที่เข้ากันได้เพียงเพราะทั้งคู่รับ Authorization header

ส่งคำขอ Responses และอ่านคำตอบ

สร้าง astra-example.mjs ด้วยโค้ดต่อไปนี้ แล้วรัน node astra-example.mjs พรอมป์จะขอ checklist สั้นๆ เพื่อให้คุณตรวจคำตอบที่ส่งกลับก่อนเชื่อมต่อเวิร์กโฟลว์ขนาดใหญ่ การรีทรายอัตโนมัติของ SDK ถูกปิดไว้สำหรับคำขอแรก ทำให้วินิจฉัยข้อผิดพลาดด้านการเชื่อมต่อหรือบัญชีได้ง่ายขึ้น

เมื่อสถานะเป็น completed ค่า response.output_text จะมีเอาต์พุตข้อความรวมของ SDK พิมพ์ลง standard output เพื่อให้โปรแกรมอื่นใช้ต่อหรือเปลี่ยนเส้นทางไปยังไฟล์ ส่งเมทาดาทาของ response ไปที่ standard error เพื่อแยกจากคำตอบ หาก response ไม่สมบูรณ์ ให้เก็บ incomplete_details และ usage ไว้ และคืนค่า 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
}

เลือกการยืนยันตัวตนด้วยคีย์ API สำหรับ Codex ภายในเครื่อง

OpenAI ระบุการเข้าสู่ระบบด้วยคีย์ API สำหรับงาน Codex ภายในเครื่อง ใน CLI ให้ตรวจสอบ codex login status ก่อนเปลี่ยนข้อมูลรับรอง คำสั่ง stdin ตามเอกสารด้านล่างช่วยหลีกเลี่ยงการวาง secret ในอาร์กิวเมนต์ของคำสั่ง หลังเข้าสู่ระบบ ให้ตรวจวิธีการยืนยันตัวตนที่ใช้งานอยู่อีกครั้ง แล้วเลือกโมเดลที่ตรงกันด้วย flag โมเดลของ CLI

คำสั่งสุดท้ายจะเปิดเซสชันแบบโต้ตอบโดยเลือก Astra ไว้ เริ่มจากไดเรกทอรีโปรเจกต์เพื่อให้เอเจนต์อ่านไฟล์และคำแนะนำของรีโพที่ถูกต้อง ตรวจสอบการ override ผู้ให้บริการที่มีอยู่และยืนยันบัญชีที่ใช้งาน โหมดคีย์ API รองรับงานภายในเครื่อง ส่วน Codex cloud ต้องใช้การยืนยันตัวตนผ่าน ChatGPT หากต้องการทำงาน cloud ต่อภายในเครื่อง ให้นำไฟล์งานและสรุปสั้นๆ ของงานที่เหลือมายังโปรเจกต์ภายในเครื่องก่อน

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

จับคู่ความสามารถกับเส้นทางของไคลเอนต์

Astra รองรับ Responses และ Chat Completions แต่การเรียกใช้เครื่องมือต้องใช้ Responses ใช้ Responses สำหรับเอเจนต์ที่เรียกใช้ฟังก์ชันหรือ custom tools ไคลเอนต์ที่เขียนมาเพื่ออ่าน chat choices จะวิเคราะห์เอาต์พุต Responses ไม่ได้ด้วยการเปลี่ยน URL อย่างเดียว และ smoke test ที่มีเฉพาะข้อความไม่ทดสอบ tool loop

เพิ่มความสามารถทีละอย่างโดยใช้ตัวอย่างเล็กๆ จากแอปพลิเคชัน สำหรับเครื่องมือ ให้ตรวจสอบอาร์กิวเมนต์ รันฟังก์ชันในแอปพลิเคชัน และส่งผลลัพธ์กลับผ่าน Responses พร้อม call_id ที่ตรงกัน สำหรับเอาต์พุตแบบมีโครงสร้าง ให้ตรวจสคีมาและจัดการ response ที่ไม่สมบูรณ์ สำหรับสตรีมมิง ให้ประมวลผลทั้ง completion และ cancellation events รวมถึงข้อความ เก็บคำขอข้อความแบบง่ายไว้เป็นเส้นทางวินิจฉัยระหว่างเพิ่มฟีเจอร์เหล่านี้

วินิจฉัยการเข้าถึง อัตรา และข้อผิดพลาดการเสร็จสิ้นแยกกัน

ใช้สถานะ HTTP และฟิลด์ข้อผิดพลาดแบบมีโครงสร้างก่อนรีทราย คู่มือข้อผิดพลาดของ OpenAI แยกการยืนยันตัวตนไม่ถูกต้อง เครดิตหมด ขีดจำกัดการใช้จ่ายที่บังคับใช้ และแรงกดดันจากอัตราคำขอ โดยเฉพาะ response 429 เพียงอย่างเดียวไม่พอที่จะเลือกวิธีแก้ ตรวจสอบ error.code และการตั้งค่าบัญชีที่เกี่ยวข้อง

สำหรับแรงกดดันจากอัตราชั่วคราว ให้ทำตาม Retry-After หากมี และใช้รีทรายที่มีขอบเขต ความล้มเหลวด้านการเรียกเก็บเงินหรือขีดจำกัดการใช้จ่ายต้องตัดสินใจในระดับบัญชี ไม่ใช่ส่งคำขอซ้ำ ผลลัพธ์ Responses ที่ถูกระบุว่า incomplete เป็นอีกเงื่อนไขหนึ่ง และอาจใช้โทเค็นไปแล้ว เก็บข้อมูลข้อผิดพลาดและ usage ที่ลบข้อมูลสำคัญแล้ว อย่าเปลี่ยน timeout หรือใบเสร็จที่หายไปให้เป็นความสำเร็จหรือการลองใช้ฟรี

สถานะการให้บริการและหลักฐาน: 5 กันยายน 2026

OpenAI ประกาศ GPT-6 Astra พร้อมการทยอยเปิดใช้งาน และเอกสารอ้างอิงโมเดลระบุ API อย่างเป็นทางการ ตัวอย่างในหน้านี้ทำตามแหล่งข้อมูลเหล่านั้น แต่ไม่ได้ส่งคำขอแบบมีค่าใช้จ่ายหรือเปลี่ยนการยืนยันตัวตนของ Codex เพื่อจัดทำคู่มือนี้ การตรวจแค็ตตาล็อกสาธารณะของ APIsRouter เมื่อวันที่ 5 กันยายน 2026 ส่งคืน HTTP 200, success: true และ 34 โมเดล โดยไม่มีรายการ Astra หรือ GPT-6

ใช้ข้อมูลรับรอง OpenAI เฉพาะกับ endpoint อย่างเป็นทางการที่แสดงด้านบน ตรวจสอบรายการของ APIsRouter จากแค็ตตาล็อกแบบไลฟ์ หากภายหลังมี Astra ในรายการ ก็ยังต้องตรวจสอบ model ID ราคา และฟีเจอร์ไคลเอนต์ที่ต้องการก่อนใช้ในแอปพลิเคชัน

เชื่อมต่อ response เข้ากับเวิร์กโฟลว์ภายในเครื่องที่มีประโยชน์

เลือกงานภายในเครื่องหนึ่งงานที่มีผลลัพธ์ชัดเจน เช่น อธิบายฟังก์ชันและเสนอการทดสอบ ระบุพาธไฟล์ที่เกี่ยวข้อง พฤติกรรมที่คาดหวัง และคำสั่งทดสอบให้เอเจนต์ หลังเปลี่ยนโค้ด ให้ตรวจ diff และรันการทดสอบแบบเจาะจง เก็บอินพุตเดิมและคำตอบที่ส่งกลับไว้ด้วยกันเพื่อเปรียบเทียบการแก้ไขได้ง่าย

ในแอปพลิเคชัน ให้ส่งข้อความที่ completed แล้วไปยังหน้าตรวจสอบหรือ document pipeline หากขั้นตอนถัดไปต้องการข้อมูลที่เครื่องอ่านได้ ให้ใช้เอาต์พุตแบบมีโครงสร้างและตรวจฟิลด์ที่จำเป็นก่อนบันทึก เก็บตัวตนของคำขอและ usage ไว้กับงาน และตั้งนโยบายรีทรายที่มีขอบเขต ขยายเวิร์กโฟลว์หลังจากอินพุต การจัดการ response และการตรวจการเสร็จสิ้นทำงานร่วมกันได้แล้ว

คำถามที่พบบ่อย