Tài liệu API Apinhanh

Apinhanh là nền tảng API gateway cung cấp quyền truy cập đến các mô hình AI hàng đầu như Claude, GPT, Gemini với mức giá tiết kiệm và tích hợp nhanh chóng. Tài liệu này hướng dẫn bạn từ cài đặt đến sử dụng API.

# OpenAI compatible (Cursor, Cline, Aider...)
https://api.openai.com/v1  →  https://apikey-landing.vercel.app/v1

# Anthropic compatible (Claude Code, Amp Code...)
https://api.anthropic.com  →  https://apikey-landing.vercel.app

Tại sao chọn Apinhanh?

Một key, nhiều model

Thay vì đăng ký và quản lý API key từ nhiều provider (OpenAI, Anthropic, Google...), Apinhanh cung cấp một API key duy nhất để truy cập tất cả model. Tiết kiệm thời gian quản lý và đơn giản hóa việc tích hợp.

Tương thích 99.99% với API gốc

Apinhanh hoạt động như một proxy hoàn toàn tương thích. Bạn không cần thay đổi bất kỳ dòng code nào ngoài Base URL và API key. Toàn bộ format request/response đều được hỗ trợ nguyên bản:

• Streaming (SSE)
• Vision / Image input
• Function calling / Tool use
• Extended thinking / Reasoning mode
• Prompt caching
• Tất cả các model mới nhất

Hỗ trợ đa dạng công cụ

Apinhanh đã được kiểm tra và hoạt động tốt với các coding agent phổ biến:

Cách hoạt động

Chỉ cần 3 bước đơn giản để bắt đầu sử dụng Apinhanh:

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.

1. Nhận API Key

Đăng ký tài khoản, chọn gói phù hợp và thanh toán. API key có tiền tố sk- sẽ hiển thị ngay trên Dashboard sau khi thanh toán thành công.

2. Chọn đúng Base URL

Tùy vào tool đang dùng, chọn endpoint phù hợp:

# OpenAI compatible — Cursor, Codex CLI, Cline, Continue, Aider
https://apikey-landing.vercel.app/v1

# Anthropic compatible — Claude Code, Amp Code
https://apikey-landing.vercel.app

3. Test API

Kiểm tra kết nối bằng cURL:

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Xác thực API

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

Authorization: Bearer sk-xxxxx

# hoặc

X-API-Key: sk-xxxxx

Base URL

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

Endpoints có sẵn

Claude Code

Claude Code là CLI agent chính thức của Anthropic. Có 2 cách cấu hình Apinhanh.

Cách 1: File settings.json (Khuyến nghị)

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://apikey-landing.vercel.app",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "ap-gemini-3.1-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "ap-gemini-3.1-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "ap-gemini-3.1-pro",
    "API_TIMEOUT_MS": "3000000"
  },
  "disableLoginPrompt": true
}

Cách 2: Biến môi trường

Khi dùng custom Base URL, ưu tiên ANTHROPIC_AUTH_TOKEN (Bearer). Không dùng ANTHROPIC_API_KEY thay thế nếu gặp lỗi 401.

export ANTHROPIC_BASE_URL="https://apikey-landing.vercel.app"
export ANTHROPIC_AUTH_TOKEN="sk-your-key-here"
claude

$env:ANTHROPIC_BASE_URL = "https://apikey-landing.vercel.app"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key-here"
claude

Lỗi: API key required for remote API access

Lỗi này do Claude Code chưa đọc được API key khi bạn trỏ ANTHROPIC_BASE_URL sang Apinhanh — request chưa tới server của chúng tôi.

1. Kiểm tra đường dẫn file: %USERPROFILE%\\.claude\\settings.json (Windows) hoặc ~/.claude/settings.json (macOS/Linux).
2. Trong env phải có ANTHROPIC_AUTH_TOKEN = full key sk-ap_... (~39 ký tự). Prefix trên Dashboard không dùng được.
3. ANTHROPIC_BASE_URL = https://apikey-landing.vercel.app (không cần thêm /v1).
4. Đóng hết terminal, mở terminal mới, chạy claude /status — phải thấy Auth token.
5. Nếu vẫn lỗi: gỡ biến ANTHROPIC_API_KEY cũ trong Windows Environment Variables.

Cursor

Cursor dùng chuẩn OpenAI. Claude phải thêm model ap-claude-* — nếu dùngclaude-* thuần, Cursor sẽ gọi Anthropic built-in và báo model unavailable.

1. Mở Cursor Settings → Models
2. Bật OpenAI API Key, dán API key từ Dashboard (sk-...)
3. Bật Override OpenAI Base URL: https://apikey-landing.vercel.app/v1
4. Add custom model — gõ đúng (dùng gạch ngang, không dùng dấu chấm):
   • ap-claude-opus-4-8
   • ap-claude-opus-4-7
   • ap-claude-sonnet-4-5
   • ap-grok-4.5
5. Bật toggle model vừa thêm → chọn trong chat / Agent

OpenAI API Key:     sk-...          (copy từ Dashboard)
Override Base URL:  https://apikey-landing.vercel.app/v1

# Claude (Kiro) — BẮT BUỘC prefix ap-
ap-claude-opus-4-8
ap-claude-opus-4-7
ap-claude-sonnet-4-5
ap-claude-haiku-4-5

# Grok
ap-grok-4.5

Codex CLI

Codex CLI (OpenAI) dùng Responses API. Cấu hình trong ~/.codex/config.toml:

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

[model_providers.apinhanh]
name = "Apinhanh"
base_url = "https://apikey-landing.vercel.app/v1"
env_key = "MUAAPIKEY_API_KEY"
wire_api = "responses"
requires_openai_auth = false

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

Cline

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

1. Mở Cline Settings trong VS Code
2. Provider: chọn OpenAI Compatible(không phải "OpenAI")
3. Base URL: https://apikey-landing.vercel.app/v1
4. API Key: sk-your-key-here
5. Model ID: claude-sonnet-4-5

Continue

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

name: Apinhanh
version: 1.0.0
schema: v1

models:
  - name: Apinhanh Sonnet
    provider: openai
    model: claude-sonnet-4-5
    apiBase: https://apikey-landing.vercel.app/v1
    apiKey: sk-your-key-here
    roles:
      - chat
      - edit
      - apply

Aider

Aider cần set cả hai biến OPENAI_API_BASE và OPENAI_BASE_URL:

export OPENAI_API_BASE="https://apikey-landing.vercel.app/v1"
export OPENAI_BASE_URL="https://apikey-landing.vercel.app/v1"
export OPENAI_API_KEY="sk-your-key-here"

aider --model openai/claude-sonnet-4-5

model: openai/claude-sonnet-4-5
openai-api-base: https://apikey-landing.vercel.app/v1
openai-api-key: sk-your-key-here

Amp Code

Amp (Sourcegraph) gọi chuẩn Anthropic Messages:

export ANTHROPIC_BASE_URL="https://apikey-landing.vercel.app"
export ANTHROPIC_API_KEY="sk-your-key-here"

1. Settings/provider: chọn Anthropic-compatible
2. Base URL: https://apikey-landing.vercel.app
3. API Key: sk-your-key-here
4. Model: claude-sonnet-4-5

Công cụ khác

Mọi tool hỗ trợ chuẩn OpenAI Chat Completions hoặc Anthropic Messages đều có thể sử dụng Apinhanh.

# OpenAI compatible (Cursor, Cline, Continue, Aider, Roo Code...)
export OPENAI_BASE_URL="https://apikey-landing.vercel.app/v1"
export OPENAI_API_KEY="sk-your-key-here"

# Anthropic compatible (Claude Code, Amp Code...)
export ANTHROPIC_BASE_URL="https://apikey-landing.vercel.app"
export ANTHROPIC_API_KEY="sk-your-key-here"

OpenAI / GPT Models

Apinhanh hỗ trợ đầy đủ các model OpenAI bao gồm GPT-4o, GPT-5.x series, O-series (reasoning), DALL-E, Whisper và các model embedding.

Models phổ biến

Cách sử dụng

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ap-gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}],
    "temperature": 0.7
  }'

Tính năng hỗ trợ

• Streaming: Hỗ trợ đầy đủ SSE streaming
• Vision: Gửi ảnh với GPT-4o, GPT-4 Turbo
• Function calling: Tool use với tất cả GPT models
• JSON mode: Response format structured
• Prompt caching: Hỗ trợ với các model có cache

Anthropic / Claude Models

Hỗ trợ đầy đủ Claude family từ Haiku đến Opus. Tương thích 100% với Anthropic Messages API.

Models phổ biến

Anthropic Messages API

curl https://apikey-landing.vercel.app/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": "Hello!"}]
  }'

OpenAI-compatible endpoint

Claude models cũng hoạt động qua OpenAI endpoint:

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Tính năng hỗ trợ

• Extended thinking: Reasoning mode với Opus
• Vision: Phân tích ảnh với tất cả Claude models
• Tool use: Function calling đầy đủ
• Prompt caching: Tiết kiệm với long context
• System prompt: Hỗ trợ system message

Google / Gemini Models

Antigravity (9Router) + Gemini legacy. Giá chuẩn theo tier High / Medium / Low.

Models phổ biến

Cách sử dụng

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.0-flash",
    "messages": [{"role": "user", "content": "Explain quantum computing"}],
    "temperature": 0.7
  }'

Tính năng đặc biệt

• Antigravity: Route qua ag/* — Pro / Flash / GPT-OSS
• Multimodal: Hỗ trợ vision trên Gemini Pro & Flash
• Tier giá: High / Medium / Low — credit giảm theo tier
• Legacy: gemini-2.5-* vẫn map sang Antigravity

DeepSeek Models

DeepSeek nổi tiếng với giá rẻ và hiệu năng cao, đặc biệt là DeepSeek R1 cho reasoning.

Models phổ biến

Cách sử dụng

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-r1",
    "messages": [{"role": "user", "content": "Solve this math problem step by step: ..."}],
    "temperature": 0
  }'

Qwen / Alibaba Models

Qwen (Alibaba) cung cấp đa dạng model từ chat, vision đến coding với giá cạnh tranh.

Models phổ biến

Cách sử dụng

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-plus",
    "messages": [{"role": "user", "content": "Write a Python function to..."}]
  }'

Vision với Qwen VL

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-vl-max",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "Describe this image"},
        {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
      ]
    }]
  }'

Mistral Models

Mistral AI cung cấp các model hiệu quả từ Mistral Small đến Large, cùng với Codestral cho coding.

Models phổ biến

Cách sử dụng

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large",
    "messages": [{"role": "user", "content": "Explain machine learning"}]
  }'

Meta / Llama Models

Llama là dòng model open-source của Meta, từ Llama 3 đến Llama 4 với nhiều kích thước khác nhau.

Models phổ biến

Cách sử dụng

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Các Provider Khác

Apinhanh hỗ trợ thêm nhiều provider khác với 408+ models. Tất cả đều sử dụng cùng một API key và endpoint.

Zhipu / GLM (Trung Quốc)

Baidu / ERNIE (Trung Quốc)

Moonshot / Kimi

xAI / Grok

Perplexity (Search)

Cohere (RAG)

API Reference

Tài liệu chi tiết cho tất cả endpoints của Apinhanh API.

Chat Completions API

Endpoint chính cho OpenAI-compatible tools như Cursor, Cline, Aider.

curl https://apikey-landing.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024,
    "stream": true
  }'

Parameters

Messages API (Anthropic)

Endpoint cho Anthropic-compatible tools như Claude Code, Amp Code.

curl https://apikey-landing.vercel.app/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": "Hello!"}
    ]
  }'

Parameters

Models Endpoint

Lấy danh sách tất cả models có sẵn trên Apinhanh.

curl https://apikey-landing.vercel.app/v1/models \
  -H "Authorization: Bearer sk-your-key"

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4-5",
      "object": "model",
      "owned_by": "Anthropic",
      "input_credit_per_1m": 6,
      "output_credit_per_1m": 15
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "owned_by": "Anthropic",
      "input_credit_per_1m": 10,
      "output_credit_per_1m": 25
    }
  ]
}

Models hỗ trợ

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

Chính sách giá

Gói tháng

Credit Top-up

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

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 cho từng key.

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-

Error 402: Hết quota

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

Connection refused

Kiểm tra Base URL:

# Anthropic (Claude Code, Amp Code)
https://apikey-landing.vercel.app

# OpenAI (Cursor, Cline, Aider)
https://apikey-landing.vercel.app/v1

Cursor: Model không hiện

• Base URL phải có /v1
• Model ID phải khớp catalog (claude-sonnet-4-5, ap-grok-4.5)
• API Key là sk-... từ Dashboard

Cline: Cannot connect

Chọn OpenAI Compatible, không phải "OpenAI" thuần.

FAQ

Liên hệ hỗ trợ

Khi gặp vấn đề, vui lòng cung cấp:

• Mã lỗi / Response nhận được
• Tên model đang sử dụng
• Request ID (nếu có)
• Thời điểm xảy ra lỗi