XKey

Cài đặt công cụ với XKey

Hầu hết công cụ AI/coding đều tương thích OpenAI — chỉ cần đổi Base URL và API key là dùng được toàn bộ 340+ model.

Base URL

https://xkey.click/v1

API key

Tạo tại Bảng điều khiển → API keys (dạng sk-xkey-...)

Model ID

Dùng slug ở Model & Bảng giá (vd gpt-5-mini)

Claude Code & Anthropic

Lưu ý: các công cụ Anthropic dùng base URL không có hậu tố /v1 (Claude Code tự thêm /v1/messages): https://xkey.click

Claude Code

Đề xuất

CLI của Anthropic — trỏ endpoint về XKey qua biến môi trường.

  1. Cài Claude Code, sau đó xuất 2 biến môi trường rồi chạy claude.
  2. Đặt model là slug Claude của XKey (vd claude-opus-4-8).
export ANTHROPIC_BASE_URL="https://xkey.click"
export ANTHROPIC_AUTH_TOKEN="sk-xkey-..."
export ANTHROPIC_MODEL="claude-opus-4-8"
claude

Anthropic SDK (Python / Node)

Dùng SDK Anthropic với base_url của XKey.

# Python
from anthropic import Anthropic
client = Anthropic(api_key="sk-xkey-...", base_url="https://xkey.click")

resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Xin chào"}],
)

Công cụ tương thích OpenAI

OpenAI SDK (Python / Node)

Chuẩn

Mọi thư viện OpenAI chỉ cần đổi base_url + api_key.

# Python
from openai import OpenAI
client = OpenAI(api_key="sk-xkey-...", base_url="https://xkey.click/v1")

# Node.js
# new OpenAI({ apiKey: "sk-xkey-...", baseURL: "https://xkey.click/v1" })

Codex CLI

Đề xuất

CLI của OpenAI dùng Responses API — khai báo provider trong ~/.codex/config.toml.

  1. Thêm provider XKey vào ~/.codex/config.toml.
  2. Đặt API key qua biến môi trường rồi chạy codex.
# ~/.codex/config.toml
model = "gpt-5-mini"
model_provider = "xkey"

[model_providers.xkey]
name = "XKey"
base_url = "https://xkey.click/v1"
env_key = "XKEY_API_KEY"
wire_api = "responses"

# Sau đó chạy:
#   export XKEY_API_KEY="sk-xkey-..."
#   codex

Cursor

Settings → Models → bật "Override OpenAI Base URL".

  1. Mở Settings → Models.
  2. Override OpenAI Base URL = https://xkey.click/v1
  3. OpenAI API Key = sk-xkey-... rồi bấm Verify.
  4. Thêm tên model (vd gpt-5-mini) vào danh sách model.
Base URL : https://xkey.click/v1
API Key  : sk-xkey-...
Model    : gpt-5-mini | claude-opus-4-8 | deepseek-v4-pro ...

Cline / Roo Code (VS Code)

API Provider chọn "OpenAI Compatible".

  1. API Provider: OpenAI Compatible.
  2. Base URL: https://xkey.click/v1
  3. API Key: sk-xkey-...
  4. Model ID: nhập slug model (vd claude-opus-4-8).
Provider : OpenAI Compatible
Base URL : https://xkey.click/v1
API Key  : sk-xkey-...
Model ID : claude-opus-4-8

Continue (VS Code / JetBrains)

Sửa file cấu hình ~/.continue/config.json.

{
  "models": [
    {
      "title": "XKey",
      "provider": "openai",
      "model": "gpt-5-mini",
      "apiBase": "https://xkey.click/v1",
      "apiKey": "sk-xkey-..."
    }
  ]
}

Aider

Trợ lý code trong terminal.

export OPENAI_API_BASE="https://xkey.click/v1"
export OPENAI_API_KEY="sk-xkey-..."
aider --model gpt-5-mini

Cherry Studio / LobeChat / ChatGPT-Next-Web

Các app chat hỗ trợ nhà cung cấp OpenAI tuỳ chỉnh.

  1. Thêm nhà cung cấp kiểu OpenAI.
  2. API Host / Base URL: https://xkey.click/v1
  3. API Key: sk-xkey-... và thêm model muốn dùng.
Provider : OpenAI (custom)
Base URL : https://xkey.click/v1
API Key  : sk-xkey-...

Lỗi thường gặp

MãLoạiCách xử lý
401invalid_api_keySai/không có API key. Kiểm tra header Authorization: Bearer sk-xkey-...
402insufficient_balanceHết số dư ví. Nạp thêm hoặc mua gói XKeyCode.
403model_not_allowedKey bị giới hạn model. Bỏ giới hạn trong trang API keys.
404model_not_foundSai tên model. Xem đúng slug ở trang Model & Bảng giá.
429rate_limit_exceededVượt RPM của key. Giảm tần suất hoặc tăng hạn mức key.

Mẹo gỡ lỗi: test nhanh bằng lệnh curl trước khi cấu hình vào công cụ:

curl https://xkey.click/v1/chat/completions \
  -H "Authorization: Bearer sk-xkey-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5-mini","messages":[{"role":"user","content":"ping"}]}'