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

# Anthropic compatible (Claude Code, Amp Code)
https://api.apikey247.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

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

Claude Code

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

Cách 1 — Cấu hình file settings.json

Chỉnh sửa file cấu hình tại ~/.claude/settings.json (tạo mới nếu chưa có). Cách này áp dụng vĩnh viễn, không cần set lại mỗi lần mở terminal.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "toc-329774f9fbe1c50cb0bedf4569bad949-zpsyxl-abbff04b",
    "ANTHROPIC_BASE_URL": "https://api.apikey247.com",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-pro-agent",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-pro-agent",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-pro-agent",
    "API_TIMEOUT_MS": "3000000"
  },
  "disableLoginPrompt": true
}

Vị trí file theo hệ điều hành:

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

Set biến môi trường trong terminal hiện tại. Chỉ có hiệu lực trong phiên làm việc đó — cần set lại mỗi lần mở terminal mới.

Linux / macOS

export ANTHROPIC_BASE_URL="https://api.apikey247.com"
export ANTHROPIC_API_KEY="YOUR_KEY"

# Khởi chạy Claude Code
claude

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.apikey247.com"
$env:ANTHROPIC_API_KEY = "YOUR_KEY"

# Khởi chạy Claude Code
claude

Cursor

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

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

Cline

Cấu hình APIKey247 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.apikey247.com/v1
4. Nhập API Key: sk-your-key-here

Công cụ khác

APIKey247 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.apikey247.com/v1"
export OPENAI_API_KEY="sk-your-key-here"

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

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

Quản lý API Keys

Mỗi tài khoản APIKey247 có thể tạo tối đa 10 API Key. Bạn có thể đặt tên gợi nhớ, bật/tắt từng key, theo dõi chi phí riêng — giúp quản lý nhiều dự án, bot hoặc nhân viên trên cùng một tài khoản.

Tổng quan

Tạo key mới

Đổi tên key

Trong bảng API Keys trên Dashboard, nhấn biểu tượng bút chỉnh sửa (✏️) bên cạnh key cần đổi tên. Nhập tên mới và xác nhận.

Bật / Tắt key

Nhấn biểu tượng tắt (⊘) để vô hiệu hóa key. Key bị tắt sẽ không thể dùng để gọi API — mọi request với key đó sẽ bị từ chối. Nhấn biểu tượng bật (✓) để kích hoạt lại.

Xem thống kê từng key

Nhấn vào tên key trong bảng để xem trang chi tiết, bao gồm:

• Biểu đồ chi phí 30 ngày — theo dõi xu hướng sử dụng của key
• Lịch sử sử dụng 24 giờ — chi tiết từng request: model, token in/out, chi phí
• Chi phí 30 ngày và tổng chi phí từ lúc tạo key

Ví dụ sử dụng nhiều key

# Key cho dự án chính (Claude Code)
export ANTHROPIC_API_KEY=sk-b8fd...-key1

# Key cho bot Discord (Python script)
OPENAI_API_KEY=sk-b8fd...-key2

# Key cho nhân viên A (Cursor)
# → Cấu hình trong Cursor Settings > API Key
sk-b8fd...-key3

Mỗi key hoạt động độc lập, có thống kê riêng, nhưng chia sẻ chung số dư credit của tài khoản. Điều này giúp bạn dễ dàng theo dõi chi phí theo từng dự án hoặc từng người sử dụng.

Tham chiếu API

APIKey247 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.apikey247.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Xin chào!"}
    ]
  }'

curl https://api.apikey247.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-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ả và giá token để bạn chọn đúng model cho nhu cầu.

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 và huỷ 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ố

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: sk-

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

Lỗi kết nối

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

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

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

Lỗi IDE / Agent

FAQ