Thiết lập Astra API với xác thực OpenAI chính thức

Bắt đầu với nhà cung cấp và tài khoản thanh toán

Dùng gpt-6-astra qua API OpenAI với key OpenAI Platform của bạn. Với ứng dụng, hãy bắt đầu bằng ví dụ Responses bên dưới. Với công việc lập trình cục bộ, dùng lệnh đăng nhập và chọn mô hình của Codex CLI. Cả hai đường dùng tài khoản Platform và phát sinh phí API theo giá OpenAI áp dụng.

Trước khi chạy, xác nhận ai sở hữu project Platform, key có thể truy cập mô hình không và kiểm soát thanh toán nào áp dụng. Mô hình xuất hiện trong ChatGPT hoặc Codex không cấp quyền cho mọi project API. Giữ đăng nhập thuê bao và đăng nhập bằng API key riêng trong ghi chú chạy. Phân biệt này thiết yếu khi chẩn đoán giới hạn hoặc đối soát phí sau.

Chuẩn bị key và client trong môi trường đáng tin

Tạo API key trong dashboard OpenAI và cung cấp nó dưới dạng OPENAI_API_KEY qua môi trường riêng hoặc trình quản lý bí mật. SDK chính thức đọc biến đó. Không nhúng key vào JavaScript trình duyệt, repository công khai, ảnh chụp hoặc transcript terminal chia sẻ. Tránh shell tracing khi xử lý thông tin xác thực.

Với ví dụ JavaScript bên dưới, cài gói openai chính thức trong project bằng npm install openai. Ghi phiên bản đã cài vào lockfile. baseURL rõ ràng chọn OpenAI thay vì endpoint tùy chỉnh kế thừa. Đồng thời rà soát cấu hình agent hiện có: override nhà cung cấp và credential từ dịch vụ khác không tự trở nên tương thích chỉ vì cả hai chấp nhận header Authorization.

Gửi yêu cầu Responses và đọc câu trả lời

Tạo astra-example.mjs bằng mã sau, rồi chạy node astra-example.mjs. Prompt yêu cầu checklist ngắn để bạn kiểm tra câu trả lời trả về trước khi kết nối quy trình lớn hơn. Lần yêu cầu đầu tắt retry tự động của SDK, giúp chẩn đoán lỗi kết nối hoặc tài khoản dễ hơn.

Khi status là completed, response.output_text chứa phần văn bản kết hợp của SDK. In nó ra standard output để chương trình khác tiêu thụ hoặc chuyển hướng vào tệp. Gửi metadata response vào standard error để tách khỏi câu trả lời. Với response chưa hoàn chỉnh, giữ incomplete_details và usage rồi trả mã thoát khác không.

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
}

Chọn xác thực bằng API key cho Codex cục bộ

OpenAI ghi nhận đăng nhập bằng API key cho công việc Codex cục bộ. Trong CLI, kiểm tra trạng thái đăng nhập codex trước khi đổi credential. Lệnh stdin được ghi nhận bên dưới tránh dán bí mật vào đối số lệnh. Sau khi đăng nhập, kiểm tra lại phương thức xác thực đang hoạt động, rồi chọn đúng mô hình bằng flag mô hình CLI.

Lệnh cuối mở phiên tương tác với Astra đã chọn. Bắt đầu trong thư mục project để agent đọc đúng tệp và chỉ dẫn repository. Rà soát override nhà cung cấp hiện có và xác nhận tài khoản đang hoạt động. Chế độ API key hỗ trợ công việc local; Codex cloud cần xác thực ChatGPT. Với tác vụ cloud muốn tiếp tục ở local, trước tiên đưa tệp làm việc cùng tóm tắt ngắn phần còn lại vào project local.

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

Ghép năng lực với đường client

Astra hỗ trợ Responses và Chat Completions, nhưng tool calling bắt buộc Responses. Dùng Responses cho agent thực thi function hoặc custom tool. Client viết để đọc chat choices không thể parse output Responses chỉ bằng đổi URL, và smoke text-only không kiểm tra vòng tool.

Thêm từng năng lực một bằng ví dụ nhỏ của ứng dụng. Với tool, xác thực argument, chạy function trong ứng dụng rồi trả kết quả qua Responses với call_id tương ứng. Với output có cấu trúc, xác thực schema và xử lý response chưa hoàn chỉnh. Với streaming, xử lý cả event hoàn tất và hủy cùng văn bản. Giữ yêu cầu văn bản đơn giản khả dụng làm đường chẩn đoán khi thêm tính năng.

Chẩn đoán riêng lỗi truy cập, tốc độ và hoàn tất

Dùng status HTTP và trường lỗi có cấu trúc trước khi thử lại. Hướng dẫn lỗi OpenAI phân biệt xác thực không hợp lệ, credit cạn, giới hạn chi tiêu bị áp dụng và áp lực tốc độ yêu cầu. Đặc biệt, response 429 chưa đủ để chọn biện pháp: kiểm tra error.code và cài đặt tài khoản liên quan.

Với áp lực tốc độ tạm thời, tôn trọng Retry-After nếu có và dùng thử lại có giới hạn. Lỗi thanh toán hoặc giới hạn chi tiêu cần quyết định tài khoản, không phải yêu cầu lặp lại. Response Responses có status incomplete lại là điều kiện khác và có thể đã tiêu thụ token. Giữ thông tin lỗi đã làm sạch và usage; đừng biến timeout hoặc biên nhận thiếu thành lần thử thành công hay miễn phí.

Khả dụng nhà cung cấp và bằng chứng: ngày 5 tháng 9 năm 2026

OpenAI đã công bố GPT-6 Astra với đợt phát hành theo giai đoạn và tham chiếu mô hình ghi nhận API chính thức. Ví dụ ở đây theo các nguồn đó; hướng dẫn này chưa chạy yêu cầu trả phí hay chuyển xác thực Codex. Lần kiểm tra danh mục công khai APIsRouter ngày 5 tháng 9 năm 2026 trả về HTTP 200, success: true và 34 mô hình, không có mục Astra hoặc GPT-6.

Chỉ dùng credential OpenAI với endpoint chính thức nêu trên. Kiểm tra danh mục APIsRouter trực tiếp cho sản phẩm của nó. Nếu Astra được liệt kê về sau, vẫn cần kiểm tra đúng mã mô hình, giá và tính năng client bắt buộc trước khi dùng trong ứng dụng.

Kết nối response với quy trình local hữu ích

Chọn một tác vụ local có kết quả cụ thể, chẳng hạn giải thích function và đề xuất test. Cung cấp cho agent đường dẫn tệp liên quan, hành vi kỳ vọng và lệnh test. Sau khi đổi mã, kiểm tra diff và chạy test tập trung. Giữ input gốc cùng câu trả lời trả về để dễ so sánh bản sửa.

Trong ứng dụng, chuyển văn bản hoàn tất sang màn hình rà soát hoặc pipeline tài liệu. Nếu bước tiếp theo cần dữ liệu máy đọc, dùng output có cấu trúc và xác thực trường bắt buộc trước khi lưu. Giữ danh tính request và usage cùng task, đồng thời đặt chính sách retry có giới hạn. Mở rộng quy trình sau khi input cơ bản, xử lý response và kiểm tra hoàn tất hoạt động cùng nhau.

Câu hỏi thường gặp