KONG API AI Tài liệu Bắt đầu miễn phí

Công cụ

Codex

Dùng Codex với khoá KONG API AI. Thêm KONG API AI vào file config.toml của Codex và đặt khoá trong biến môi trường, trên macOS, Linux hoặc Windows.

Codex gửi yêu cầu tới KONG API AI khi bạn khai báo KONG API AI trong file cấu hình của Codex. Trên Windows, Kong Connect làm các bước này giúp bạn.

Cài Codex

Làm theo hướng dẫn cài đặt tại github.com/openai/codex.

Cách nhanh: một lệnh

Lệnh dưới đây hỏi khoá của bạn mà không hiện lên màn hình, kiểm tra khoá với KONG API AI, rồi ghi cấu hình cho Claude Code và Codex như các bước bên dưới. File cũ được sao lưu trước khi sửa.

macOS hoặc Linux:

Terminal
curl -fsSL https://kongapiai.com/install.sh | bash

Windows, trong PowerShell:

powershell
irm https://kongapiai.com/install.ps1 | iex

Để gỡ ra, chạy curl -fsSL https://kongapiai.com/install.sh | bash -s -- --remove, hoặc trên Windows chạy $env:KONG_ACTION='remove' rồi chạy lại lệnh cài. Muốn xem lệnh làm gì trước khi chạy, mở địa chỉ của lệnh trong trình duyệt.

Thêm KONG API AI vào Codex

Mở hoặc tạo file ~/.codex/config.toml (trên Windows: %USERPROFILE%\.codex\config.toml) và thêm:

toml
model_provider = "kong"
model = "gpt-6-astra"

[model_providers.kong]
name = "KONG API AI"
base_url = "https://kongapiai.com/v1"

[model_providers.kong.auth]
command = "sh"
args = ["-c", "echo $KONG_API_KEY"]

Trên Windows, thay phần auth bằng:

toml
[model_providers.kong.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:KONG_API_KEY"]

Codex cũng nhận env_key = "KONG_API_KEY" thay cho phần auth, nhưng khi đó Codex không đọc danh sách model của KONG API AI và có thể báo "Unknown model".

Đặt khoá

macOS hoặc Linux: thêm vào ~/.zshrc, ~/.bashrc hoặc ~/.config/fish/config.fish:

Terminal
export KONG_API_KEY="gw_live_…"

Windows: chạy lệnh dưới đây một lần, cho tài khoản của bạn:

powershell
setx KONG_API_KEY "gw_live_…"

Sau đó thoát hẳn Codex, kể cả app Codex trên máy, rồi mở lại. App Codex không thấy biến chỉ đặt trong một cửa sổ terminal.

Bắt đầu

Terminal
cd /đường-dẫn/tới/dự-án
codex

Sau vài yêu cầu, bạn thấy chúng trong trang Hoạt động của console.

Đổi model

Đổi giá trị model trong config.toml thành một model khác mà khoá được dùng. Xem danh sách tại Model và giá. Codex chỉ dùng được model của OpenAI.

Khi có lỗi

  • Lỗi 401, không có khoá: lệnh trong phần auth không chạy được, hoặc chưa đặt KONG_API_KEY. Trên Windows, dùng phần auth cho PowerShell, đặt khoá bằng setx, rồi mở lại Codex.
  • Lỗi 401, khoá sai: Codex đã gửi một khoá khác, ví dụ OPENAI_API_KEY. Kiểm tra lại model_provider = "kong".
  • Không tìm thấy model: kiểm tra tên model ở trang Model và giá, và khoá có được dùng model đó không.
  • Lỗi 402: hết số dư hoặc hết hạn mức tháng của khoá. Xem Hạn mức và cách chọn nguồn.