Tài liệu API Muaapikey

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

# Anthropic compatible (Claude Code, Amp Code...)
https://api.anthropic.com  →  https://muaapikey.com

Tại sao chọn Muaapikey?

Một key, nhiều model

Thay vì đăng ký và quản lý API key từ nhiều provider (OpenAI, Anthropic, Google...), Muaapikey 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

Muaapikey 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ụ

Muaapikey đã đượ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 Muaapikey:

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

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

3. Test API

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

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": "Hello!"}]
  }'

Xác thực API

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

Authorization: Bearer sk-xxxxx

# hoặc

X-API-Key: sk-xxxxx

Base URL

Muaapikey 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 Muaapikey.

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

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://muaapikey.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-key-here"
claude

$env:ANTHROPIC_BASE_URL = "https://muaapikey.com"
$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 Muaapikey — 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-nxk_... (~39 ký tự). Prefix trên Dashboard không dùng được.
3. ANTHROPIC_BASE_URL = https://muaapikey.com (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 nxk-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://muaapikey.com/v1
4. Add custom model — gõ đúng (dùng gạch ngang, không dùng dấu chấm):
   • nxk-claude-opus-4-8
   • nxk-claude-opus-4-7
   • nxk-claude-sonnet-4-5
   • nxk-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://muaapikey.com/v1

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

# Grok
nxk-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 = "muaapikey"

[model_providers.muaapikey]
name = "Muaapikey"
base_url = "https://muaapikey.com/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 Muaapikey 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://muaapikey.com/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: Muaapikey
version: 1.0.0
schema: v1

models:
  - name: Muaapikey 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 set cả hai biến OPENAI_API_BASE và OPENAI_BASE_URL:

export OPENAI_API_BASE="https://muaapikey.com/v1"
export OPENAI_BASE_URL="https://muaapikey.com/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://muaapikey.com/v1
openai-api-key: sk-your-key-here

Amp Code

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

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

1. Settings/provider: chọn Anthropic-compatible
2. Base URL: https://muaapikey.com
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 Muaapikey.

# OpenAI compatible (Cursor, 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"

OpenAI / GPT Models

Muaapikey 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://muaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nxk-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://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": "Hello!"}]
  }'

OpenAI-compatible endpoint

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

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

Hỗ trợ Gemini Pro, Flash và các model Gemma open-weight.

Models phổ biến

Cách sử dụng

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

• Long context: Gemini 1.5 Pro hỗ trợ đến 1M tokens
• Multimodal: Hỗ trợ vision và audio
• Thinking mode: Gemini Flash Thinking
• Code execution: Chạy code trực tiếp (một số model)

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

Muaapikey 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 Muaapikey API.

Chat Completions API

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

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": "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://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": "Hello!"}
    ]
  }'

Parameters

Models Endpoint

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

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

# OpenAI (Cursor, Cline, Aider)
https://muaapikey.com/v1

Cursor: Model không hiện

• Base URL phải có /v1
• Model ID phải khớp catalog (claude-sonnet-4-5, nxk-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