Tài liệu API - Codex Gateway

Hướng dẫn quan trọng

Tài liệu hướng dẫn cấu hình vào Codex

Khách hàng có thể mở nhanh tài liệu này để cấu hình Codex dùng gateway, base URL và API key được cấp.

https://docs.google.com/document/d/1xW46mXoxfT_Nz7YTi... Mở hướng dẫn

Hướng dẫn quan trọng

Tài liệu hướng dẫn cấu hình OpenClaw

Khách hàng dùng OpenClaw có thể mở tài liệu này để setup provider codex86 kết nối gateway, bao gồm cài đặt, lưu API key, cấu hình openclaw.json và test.

https://docs.google.com/document/d/1TOenlvskdU1kL_iE1... Mở hướng dẫn

Cấu hình nhanh

Thành phần	Giá trị
Provider ID	`codex86`
Base URL	`https://codex.dichvumang86.net/v1`
Adapter ưu tiên	`openai-responses`
Adapter dự phòng	`openai-completions`
Biến chứa API key	`CODEX86_API_KEY`
Nơi lưu key	`~/.openclaw/.env`
Timeout	300 giây

Ví dụ openclaw.json

{
  "gateway": { "mode": "local" },
  "agents": {
    "defaults": {
      "model": { "primary": "codex86/gpt-5.6-sol" },
      "models": { "codex86/gpt-5.6-sol": { "alias": "Codex86" } }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "codex86": {
        "baseUrl": "https://codex.dichvumang86.net/v1",
        "apiKey": "${CODEX86_API_KEY}",
        "api": "openai-responses",
        "timeoutSeconds": 300,
        "models": [
          { "id": "gpt-5.6-sol", "name": "GPT-5.6 Sol via DVM86", "input": ["text"] }
        ]
      }
    }
  }
}

Lệnh nhanh sau khi setup

openclaw config validate
openclaw gateway restart
openclaw models list --provider codex86
openclaw models status --probe --probe-provider codex86
openclaw agent --agent main --model codex86/gpt-5.6-sol --message "Xin chào"
openclaw dashboard
openclaw logs --follow

Xác thực

Mỗi request API cần header Authorization với token của user. Token có thể lấy sau khi khách hàng đăng ký/đăng nhập ở trang nạp quota.

Authorization: Bearer USER_API_TOKEN

Endpoints hỗ trợ

Route	Method	Mục đích
/v1/models	GET	Lấy danh sách model allowed.
/v1/responses	POST	Gọi Responses API.
/v1/responses/compact	POST	Gọi compact responses nếu client cần.
/v1/chat/completions	POST	Tương thích Chat Completions.

Ví dụ Responses API

curl https://codex.dichvumang86.net/v1/responses \ -H "Authorization: Bearer USER_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-sol", "input": "Viết một đoạn giới thiệu ngắn về sản phẩm." }'

Ví dụ Chat Completions

curl https://codex.dichvumang86.net/v1/chat/completions \ -H "Authorization: Bearer USER_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-sol", "messages": [ {"role": "user", "content": "Xin chào"} ], "stream": true }'

Tính quota và usage

Gateway sẽ pre-consume quota trước khi gọi upstream nếu user token hợp lệ. Sau khi có usage thực tế, hệ thống tính lại chi phí theo input, output, cache read và hoàn/thu thêm quota nếu cần.

Input

Token người dùng gửi lên model.

Cache read

Token đọc từ cache với giá riêng.

Output

Token model sinh ra trong phần trả lời.

Xem bảng giá model Đăng nhập lấy token

Tích hợp Codex Gateway như OpenAI API.