Bắt đầu nhanh

Hướng dẫn cấu hình API key, Base URL và gửi request đầu tiên. Từ đăng ký đến sử dụng chỉ mất vài phút.

# OpenAI compatible (Cursor, Codex CLI, Cline, Continue, Aider)
https://api.nexusai.vn/v1

# Anthropic compatible (Claude Code, Amp Code)
https://api.nexusai.vn

Xác thực

API key được gửi trong header của mỗi request. Hỗ trợ hai format:

Authorization: Bearer nxa-xxxxx
# hoặc
X-API-Key: nxa-xxxxx

Base URL

NexusAI cung cấp hai endpoint tương thích với các chuẩn API phổ biến:

Claude Code

Cài đặt và cấu hình NexusAI cho Claude Code:

Linux / macOS

# Cấu hình API
export ANTHROPIC_BASE_URL="https://api.nexusai.vn"
export ANTHROPIC_API_KEY="nxa-your-key-here"

# Khởi chạy Claude Code
claude

Windows (PowerShell)

# Cấu hình API
$env:ANTHROPIC_BASE_URL = "https://api.nexusai.vn"
$env:ANTHROPIC_API_KEY = "nxa-your-key-here"

# Khởi chạy Claude Code
claude

Cursor

Cấu hình NexusAI với Cursor IDE:

1. Mở Settings → Models → Add Custom Model
2. Chọn protocol: OpenAI
3. Nhập Base URL: https://api.nexusai.vn/v1
4. Nhập API Key: nxa-your-key-here
5. Chọn model muốn dùng (ví dụ: claude-sonnet-4-20250514)

Cline

Cấu hình NexusAI với Cline extension trong VS Code:

1. Mở Cline Settings trong VS Code
2. Chọn Provider: OpenAI Compatible (không phải "OpenAI")
3. Nhập Base URL: https://api.nexusai.vn/v1
4. Nhập API Key: nxa-your-key-here

Công cụ khác

NexusAI tương thích với mọi tool sử dụng chuẩn OpenAI hoặc Anthropic API. Cấu hình chung:

# Cho tool dùng chuẩn OpenAI (Cursor, Codex CLI, Cline, Continue, Aider)
export OPENAI_BASE_URL="https://api.nexusai.vn/v1"
export OPENAI_API_KEY="nxa-your-key-here"

# Cho tool dùng chuẩn Anthropic (Claude Code, Amp Code)
export ANTHROPIC_BASE_URL="https://api.nexusai.vn"
export ANTHROPIC_API_KEY="nxa-your-key-here"

Danh sách tool được hỗ trợ

Tham chiếu API

NexusAI hoạt động như một lớp trung gian giữa tool của bạn và các AI provider. Hệ thống thực hiện định tuyến thông minh, xử lý rate limit và tự động retry.

Endpoints

Ví dụ Request

curl https://api.nexusai.vn/v1/chat/completions \
  -H "Authorization: Bearer nxa-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Xin chào!"}
    ]
  }'

curl https://api.nexusai.vn/v1/messages \
  -H "X-API-Key: nxa-your-key" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Xin chào!"}
    ]
  }'

Models hỗ trợ

Danh sách model đang hỗ trợ, kèm mô tả ngắn để bạn chọn đúng model cho nhu cầu code, phân tích hoặc xử lý ngữ cảnh dài.

Chính sách Giá

Rolling Window

Mỗi gói có giới hạn sử dụng theo chu kỳ thời gian (Rolling Window). Sau mỗi chu kỳ, giới hạn được reset tự động.

Credit Top-up

• Credit top-up được mua riêng và không hết hạn theo chu kỳ gói
• Chỉ tiêu hao sau khi budget trong window hiện tại đã cạn
• Credit top-up được giữ nguyên khi đổi gói
• Credit top-up không hoàn tiền sau khi mua

Nâng cấp / Hạ cấp

• Nâng cấp: có hiệu lực ngay lập tức
• Hạ cấp: áp dụng sau khi chu kỳ thanh toán hiện tại kết thúc
• Gia hạn: kéo dài gói thêm 1 tháng

Xử lý sự cố

Các lỗi thường gặp khi cấu hình API key, Base URL và model — kèm cách khắc phục nhanh.

Lỗi xác thực

# Kiểm tra key đã set chưa
echo $ANTHROPIC_API_KEY
# Kết quả phải bắt đầu với: nxa-

# Nếu trống, chạy:
export ANTHROPIC_API_KEY="nxa-your-key-here"

Lỗi kết nối

# Anthropic format (Claude Code)
export ANTHROPIC_BASE_URL="https://api.nexusai.vn"

# OpenAI format (Cursor, Codex CLI, Cline)
export OPENAI_BASE_URL="https://api.nexusai.vn/v1"

{
  "env": {
    "API_TIMEOUT_MS": "3000000"
  }
}

Lỗi IDE / Agent

FAQ