GetCheapAI

Dùng dịch vụ trung chuyển API trong Codex

Cấu hình nhà cung cấp mô hình tùy chỉnh qua ~/.codex/config.toml.

Đọc 2 phút

Codex CLI đọc ~/.codex/config.toml khi khởi động. Bằng cách tùy chỉnh “nhà cung cấp mô hình (model provider)”, bạn có thể cho Codex kết nối tới một dịch vụ trung chuyển API tương thích với giao diện của OpenAI.

Thông tin cần chuẩn bị

Lấy các thông tin sau từ nền tảng API mà bạn đang dùng:

  • Địa chỉ API (Base URL): địa chỉ gốc của API do nền tảng cung cấp, thường kết thúc bằng /v1
  • API key (khóa API): token dùng để xác thực
  • Tên mô hình: mã định danh mô hình (model ID) mà nền tảng hỗ trợ và bạn định dùng

Cấu hình config.toml

Chỉnh sửa ~/.codex/config.toml, thêm một nhà cung cấp tùy chỉnh và đặt nó làm mặc định:

model = "your-model-name"        # Thay bằng tên mô hình mà nền tảng hỗ trợ
model_provider = "thirdparty"    # Mã định danh nhà cung cấp tùy chỉnh, tự đặt (đừng dùng openai/ollama/lmstudio)

[model_providers.thirdparty]
name = "Third-party API"
base_url = "https://example.com/v1"   # Thay bằng địa chỉ API do nền tảng cung cấp
env_key = "THIRDPARTY_API_KEY"        # Tên biến môi trường chứa API key
wire_api = "chat"                      # Điểm cuối tương thích của bên thứ ba thường dùng chat

env_key chỉ định “tên biến môi trường lưu API key”, chứ không phải bản thân API key. Hãy export biến đó trong terminal:

export THIRDPARTY_API_KEY="your-key"

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

  • Xác thực API key thất bại: nếu tiền tố API key của nền tảng khác với OpenAI và vì thế bị từ chối, bạn có thể thêm requires_openai_auth = false vào phần cấu hình của nhà cung cấp đó.
  • Chọn giao thức: điểm cuối tương thích của bên thứ ba thường dùng wire_api = "chat" (tương ứng /chat/completions).
  • Đừng ghi API key vào config.toml: dùng env_key để trỏ tới biến môi trường, tránh để API key bị lộ theo tệp cấu hình.
  • Chỉ đổi tạm thời: nếu chỉ muốn tạm thời đổi địa chỉ, bạn có thể đặt biến môi trường OPENAI_BASE_URL để ghi đè cho phiên hiện tại.

Tìm hiểu thêm