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://muaapikey.com/v1

# Anthropic compatible — Claude Code, Amp Code
https://muaapikey.com

Xác thực

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

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

Base URL

NexusKey cung cấp hai endpoint tương thích chuẩn API phổ biến:

Claude Code

Claude Code là CLI agent chính thức của Anthropic. Có 2 cách cấu hình NexusKey — chọn cách phù hợp với bạn.

Cách 1 — File settings.json

Chỉnh ~/.claude/settings.json (tạo mới nếu chưa có). Áp dụng vĩnh viễn, không cần set lại mỗi lần mở terminal.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
    "ANTHROPIC_BASE_URL": "https://muaapikey.com",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "API_TIMEOUT_MS": "3000000"
  },
  "disableLoginPrompt": true
}

Cách 2 — Biến môi trường (tạm thời)

export ANTHROPIC_BASE_URL="https://muaapikey.com"
export ANTHROPIC_API_KEY="sk-your-key-here"
claude

$env:ANTHROPIC_BASE_URL = "https://muaapikey.com"
$env:ANTHROPIC_API_KEY = "sk-your-key-here"
claude

Cursor

Cursor gọi chuẩn OpenAI. Dùng Override OpenAI Base URL (không dùng domain api.nexuskey.dev — domain đó chưa tồn tại).

1. Mở Cursor Settings → Models
2. Bật / dán OpenAI API Key = API key NexusKey (sk-nxk_... trên Dashboard)
3. Bật Override OpenAI Base URL, điền: https://muaapikey.com/v1
4. Thêm model thủ công (Add model) đúng id trong catalog, ví dụ: claude-sonnet-4-5, claude-opus-4-5, auto
5. Chọn model vừa thêm ở chat / agent rồi gửi thử một câu

OpenAI API Key:     sk-nxk_...   (copy từ Dashboard → API Keys)
Override Base URL:  https://muaapikey.com/v1
Model ID ví dụ:     claude-sonnet-4-5

Codex CLI

Codex CLI (OpenAI) dùng Responses API. Khai báo provider custom trong ~/.codex/config.toml (user-level, không dùng file trong project):

model = "claude-sonnet-4-5"
model_provider = "nexuskey"

[model_providers.nexuskey]
name = "NexusKey"
base_url = "https://muaapikey.com/v1"
env_key = "NEXUSKEY_API_KEY"
wire_api = "responses"
requires_openai_auth = false

export NEXUSKEY_API_KEY="sk-your-key-here"
codex

Cline

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

1. Mở Cline Settings trong VS Code
2. Provider: OpenAI Compatible(không phải "OpenAI")
3. Base URL: https://muaapikey.com/v1
4. API Key: sk-your-key-here
5. Model ID ví dụ: claude-sonnet-4-5 (đúng id trong catalog)

Continue

Continue dùng provider openai với apiBase trỏ về NexusKey. Sửa ~/.continue/config.yaml:

name: NexusKey
version: 1.0.0
schema: v1

models:
  - name: NexusKey Sonnet
    provider: openai
    model: claude-sonnet-4-5
    apiBase: https://muaapikey.com/v1
    apiKey: sk-your-key-here
    roles:
      - chat
      - edit
      - apply

Aider

Aider cần biến OPENAI_API_BASE (không phải chỉ OPENAI_BASE_URL) và model có prefix openai/:

export OPENAI_API_BASE="https://muaapikey.com/v1"
export OPENAI_BASE_URL="https://muaapikey.com/v1"
export OPENAI_API_KEY="sk-your-key-here"

cd /path/to/your/project
aider --model openai/claude-sonnet-4-5

model: openai/claude-sonnet-4-5
openai-api-base: https://muaapikey.com/v1
openai-api-key: sk-your-key-here

Amp Code

Amp (Sourcegraph) gọi chuẩn Anthropic Messages. Trỏ Base URL tới origin NexusKey (không thêm /v1 — SDK sẽ gọi /v1/messages):

export ANTHROPIC_BASE_URL="https://muaapikey.com"
export ANTHROPIC_API_KEY="sk-your-key-here"
# hoặc ANTHROPIC_AUTH_TOKEN — tùy phiên bản Amp

1. Settings / provider: chọn Anthropic-compatible (hoặc Custom Anthropic endpoint)
2. Base URL: https://muaapikey.com
3. API Key: key NexusKey (sk-...)
4. Model: id trong catalog, ví dụ claude-sonnet-4-5

Công cụ khác

Mọi tool nói chuyện chuẩn OpenAI Chat Completions hoặc Anthropic Messages đều gắn được NexusKey. Ví dụ biến môi trường chung:

# OpenAI compatible — Cursor, Codex CLI, Cline, Continue, Aider, Roo Code…
export OPENAI_BASE_URL="https://muaapikey.com/v1"
export OPENAI_API_KEY="sk-your-key-here"

# Anthropic compatible — Claude Code, Amp Code…
export ANTHROPIC_BASE_URL="https://muaapikey.com"
export ANTHROPIC_API_KEY="sk-your-key-here"

Quản lý API Keys

Mỗi tài khoản có thể tạo tối đa 10 API Key. Đặt tên, bật/tắt, theo dõi chi phí riêng — phù hợp nhiều dự án hoặc team trên cùng một account.

Tạo key mới

1. Đăng nhập Dashboard — phần API Keys hiển thị badge số key (ví dụ: 3/10).
2. Nhấn Tạo Key mới, đặt tên gợi nhớ.
3. Copy key và dùng với Claude Code, Cursor, Cline…

Tham chiếu API

NexusKey là lớp trung gian giữa tool và AI provider: định tuyến thông minh, rate limit và retry tự động.

curl https://muaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role":"user","content":"Xin chào!"}]
  }'

curl https://muaapikey.com/v1/responses \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "input": "Xin chào!"
  }'

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

Models hỗ trợ

Danh sách model đang hỗ trợ kèm giá token để chọn đúng nhu cầu.

Chính sách Giá

Rolling Window

Mỗi gói có giới hạn theo chu kỳ. Sau mỗi chu kỳ, giới hạn reset tự động.

Credit Top-up

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

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

• Nâng cấp: hiệu lực ngay, hủy gói cũ
• Hạ cấp: áp dụng sau khi chu kỳ thanh toán hiện tại kết thúc

Xử lý sự cố

Error 401: API key không hợp lệ

Key sai, hết hạn, hoặc chưa khai báo trong biến môi trường.

echo $ANTHROPIC_API_KEY
# Kết quả phải bắt đầu với: sk-

export ANTHROPIC_API_KEY="sk-your-key-here"

Error 402: Hết quota

Budget Rolling Window đã cạn. Đợi reset trên Dashboard, mua credit top-up, hoặc nâng cấp gói.

Connection refused / Could not resolve host

# Anthropic (Claude Code, Amp Code)
export ANTHROPIC_BASE_URL="https://muaapikey.com"

# OpenAI (Cursor, Cline, Continue, Aider)
export OPENAI_BASE_URL="https://muaapikey.com/v1"
export OPENAI_API_BASE="https://muaapikey.com/v1"

Cursor: Model không hiện / không chat được

• Base URL phải là https://muaapikey.com/v1 (có /v1)
• Model id phải khớp catalog (claude-sonnet-4-5, không phải gpt-4o mặc định của Cursor trừ khi bạn đã map)
• API Key là key sk-nxk_... từ Dashboard — không dùng session login web

Cline: Cannot connect

Chọn sai Provider — phải là OpenAI Compatible, Base URL https://muaapikey.com/v1.

Aider: 404 /chat/completions

Thiếu /v1 trong Base URL, hoặc chỉ set OPENAI_BASE_URL mà không set OPENAI_API_BASE. Set cả hai = https://muaapikey.com/v1, model dạng openai/claude-sonnet-4-5.

Codex CLI: model / auth lỗi

• base_url = https://muaapikey.com/v1, wire_api = "responses"
• Env key khớp env_key trong config (ví dụ NEXUSKEY_API_KEY=sk-...)
• Model id phải có trong GET /v1/models

FAQ