Tài liệu

Tài liệu Ai Cheap Shop

Tài liệu API và hướng dẫn cấu hình gateway cho Ai Cheap Shop.

Bắt đầu

Giới thiệu

Gateway OpenAI-compatible cho phép gọi nhiều provider qua một endpoint duy nhất. Tạo tài khoản, nạp ví, sinh API key và bắt đầu gọi API trong vài phút.

Quick start
5 bước từ tạo tài khoản đến request đầu tiên.
API Reference
Endpoint chat, quản lý API key và tài khoản.
Tích hợp công cụ
Thiết lập Claude Code, OpenCode, Codex, OpenClaw, CURL.
Model library
Tra cứu model và giá trước khi gọi API.

Quick start — 5 bước

Thực hiện lần lượt để có request đầu tiên và cấu hình CLI.

  1. 1

    Tạo tài khoản

    Đăng ký hoặc đăng nhập để mở dashboard quản lý key, usage và số dư.

    Đăng ký
  2. 2

    Nạp số dư

    Tạo phiên nạp tiền để có ngân sách gọi API qua gateway.

    Nạp tiền
  3. 3

    Tạo API key

    Sinh key riêng cho ứng dụng hoặc CLI, có thể đặt hạn mức để kiểm soát chi phí.

    Tạo key
  4. 4

    Gọi thử API

    Copy mẫu curl trong API Doc, thay API key và model rồi kiểm tra phản hồi đầu tiên.

    Xem curl
  5. 5

    Cấu hình CLI

    Chọn Claude Code, Codex CLI hoặc OpenClaw theo hệ điều hành để dùng gateway hằng ngày.

    Cấu hình

Xác thực

Mọi request tới gateway gửi API key qua header Authorization: Bearer <key>. Endpoint /api/keys nội bộ dùng session cookie từ trình duyệt.

Ví dụ header

Authorization: Bearer sk-...
Content-Type: application/json

API Reference

Danh sách endpoint

Các endpoint cần thiết để tích hợp gateway và quản lý API key. Mọi endpoint đều trả JSON, ngoại trừ chat khi bật streaming.

Chat completions

Endpoint chính để gọi AI. Tương thích chuẩn OpenAI Chat Completions API.

POSTPublic
Chat completions/v1/chat/completions
Gửi request chat tới gateway. Hệ thống tự chọn endpoint rẻ nhất theo model. Tương thích chuẩn OpenAI Chat Completions API.

Request

  • model: model cần gọi
  • messages: danh sách hội thoại
  • stream: true để nhận SSE; false hoặc bỏ trống để nhận JSON
  • stream_options: tùy chọn OpenAI-compatible, ví dụ include_usage khi streaming

Response

  • stream=false hoặc bỏ trống: trả JSON application/json theo chuẩn OpenAI
  • stream=true: trả SSE text/event-stream
  • Ghi nhận usage tự động khi provider trả usage

Ghi chú

  • API key truyền qua header Authorization: Bearer <key>.
  • Tương thích chuẩn OpenAI — dùng được với mọi SDK/CLI hỗ trợ OpenAI.

Ví dụ curl

curl -X POST "https://api.aicheap.shop/v1/chat/completions"   -H "Content-Type: application/json"   -H "Authorization: Bearer sk-..."   -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

API Keys

Tạo, cập nhật, regenerate và xóa key. Yêu cầu session đăng nhập.

POSTSession
Tạo API key/api/keys
Tạo API key cho tài khoản đang đăng nhập.

Request

  • name: tên key
  • spendingLimit: hạn mức chi tiêu
  • tokenLimit: hạn mức token

Response

  • Thông tin API key
  • Raw key chỉ hiển thị một lần

Ví dụ curl

curl -X POST "https://api.aicheap.shop/api/keys"   -H "Content-Type: application/json"   -H "Cookie: next-auth.session-token=YOUR_SESSION_TOKEN"   -d '{
    "name": "Production key",
    "spendingLimit": 500000,
    "tokenLimit": 1000000
  }'
PATCHSession
Cập nhật API key/api/keys/[id]
Cập nhật hạn mức cho API key thuộc tài khoản hiện tại.

Request

  • spendingLimit: hạn mức chi tiêu
  • tokenLimit: hạn mức token

Response

  • API key sau khi cập nhật

Ví dụ curl

curl -X PATCH "https://api.aicheap.shop/api/keys/key_123"   -H "Content-Type: application/json"   -H "Cookie: next-auth.session-token=YOUR_SESSION_TOKEN"   -d '{
    "spendingLimit": 300000,
    "tokenLimit": 750000
  }'
POSTSession
Tạo lại API key/api/keys/[id]/regenerate
Tạo raw key mới và vô hiệu hóa giá trị cũ.

Response

  • Raw key mới

Ví dụ curl

curl -X POST "https://api.aicheap.shop/api/keys/key_123/regenerate"   -H "Cookie: next-auth.session-token=YOUR_SESSION_TOKEN"
DELETESession
Xóa API key/api/keys/[id]
Vô hiệu hóa API key để key không thể gọi request mới.

Response

  • Trạng thái xử lý

Ví dụ curl

curl -X DELETE "https://api.aicheap.shop/api/keys/key_123"   -H "Cookie: next-auth.session-token=YOUR_SESSION_TOKEN"

Tài khoản

Đăng ký, kích hoạt và quản lý mật khẩu.

POSTPublic
Đăng ký tài khoản/api/auth/register
Tạo tài khoản mới và gửi email kích hoạt.

Request

  • name
  • email
  • password

Ví dụ curl

curl -X POST "https://api.aicheap.shop/api/auth/register"   -H "Content-Type: application/json"   -d '{
    "name": "Nguyen Van A",
    "email": "user@example.com",
    "password": "StrongPassword123!"
  }'

Tích hợp

Hướng dẫn cấu hình

Chọn công cụ và hệ điều hành để xem lệnh cấu hình. Mọi tool đều dùng chung Base URL và API key bên dưới.

Base URL

https://api.aicheap.shop

API Key

Tạo API key để điền tự động vào các lệnh bên dưới.

Claude Code

Tích hợp Claude Code bằng cách export biến môi trường hoặc thêm vào ~/.claude/settings.json.

Option 1 — export environment variables

export ANTHROPIC_BASE_URL=https://api.aicheap.shop
export ANTHROPIC_AUTH_TOKEN=[your_api_key]
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.4
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.4-mini

Option 2 — edit ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicheap.shop",
    "ANTHROPIC_AUTH_TOKEN": "[your_api_key]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.4",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.4-mini"
  }
}

Tài nguyên

Liên kết hữu ích

Mở dashboard, xem bảng giá hoặc thư viện model để bắt đầu nhanh hơn.

Dashboard
Quản lý API key, billing, usage logs.
Bảng giá
Xem giá theo từng model và tính chi phí.
Model library
Tra cứu model trước khi gắn route.