Hướng dẫn setup LLM API

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) message = client.messages.create( model="claude-opus-4.6", max_tokens=1024, messages=[ {"role": "user", "content": "Write a fizzbuzz in Python."} ], ) print(message.content)

# pip install anthropic from anthropic import Anthropic client = Anthropic( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io", ) with client.messages.stream( model="claude-opus-4.6", max_tokens=1024, messages=[ {"role": "user", "content": "Tell me a short story."} ], ) as stream: for text in stream.text_stream: print(text, end="", flush=True) print()

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) response = client.chat.completions.create( model="gpt-5.4", messages=[ {"role": "user", "content": "Hello from CKEY"} ], ) print(response.choices[0].message.content)

# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-YOUR_API_KEY", base_url="https://api.xah.io/v1", ) stream = client.chat.completions.create( model="gpt-5.4", stream=True, messages=[ {"role": "user", "content": "Write a short poem."} ], ) for chunk in stream: delta = chunk.choices[0].delta.content or "" if delta: print(delta, end="", flush=True) print()

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const message = await client.messages.create({ model: "claude-opus-4.6", max_tokens: 1024, messages: [{ role: "user", content: "Write a fizzbuzz in Python." }], }); console.log(message.content);

// npm install @anthropic-ai/sdk import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io", }); const stream = client.messages .stream({ model: "claude-opus-4.6", max_tokens: 1024, messages: [{ role: "user", content: "Tell me a short story." }], }) .on("text", (text) => { process.stdout.write(text); }); await stream.finalMessage(); process.stdout.write("\n");

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const response = await client.chat.completions.create({ model: "gpt-5.4", messages: [{ role: "user", content: "Hello from CKEY" }], }); console.log(response.choices[0]?.message?.content);

// npm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-YOUR_API_KEY", baseURL: "https://api.xah.io/v1", }); const stream = await client.chat.completions.create({ model: "gpt-5.4", stream: true, messages: [{ role: "user", content: "Write a short poem." }], }); for await (const chunk of stream) { const delta = chunk.choices[0]?.delta?.content ?? ""; if (delta) { process.stdout.write(delta); } } process.stdout.write("\n");

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model":"claude-opus-4.6", "max_tokens":1024, "messages":[ {"role":"user","content":"Write a fizzbuzz in Python."} ] }'

curl https://api.xah.io/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ --no-buffer \ -d '{ "model":"claude-opus-4.6", "max_tokens":1024, "stream":true, "messages":[ {"role":"user","content":"Tell me a short story."} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"gpt-5.4", "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

curl https://api.xah.io/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ --no-buffer \ -d '{ "model":"gpt-5.4", "stream":true, "messages":[ {"role":"user","content":"Write a short poem."} ] }'

curl "https://api.xah.io/v1beta/models/gemini-3.1-pro-high:generateContent" \ -H "Content-Type: application/json" \ -H "x-goog-api-key: sk-YOUR_API_KEY" \ -d '{ "contents":[ {"role":"user","parts":[{"text":"Write a fizzbuzz in Python."}]} ] }'

curl https://api.xah.io/api/chat \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-YOUR_API_KEY" \ -d '{ "model":"mistral-medium-3.5-128b", "stream":false, "messages":[ {"role":"user","content":"Hello from CKEY"} ] }'

OpenAI-compatible chat/completions /v1

Cursor

Cursor nên đi qua chế độ OpenAI-compatible với custom API key và custom base URL.

Thông tin cần điền

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions
Yêu cầu gói: Cần gói Cursor hỗ trợ custom API endpoint.

Các bước đề xuất

1Mở Cursor Settings rồi vào khu vực AI / Models / API Keys.
2Bật custom OpenAI key hoặc custom provider nếu bản Cursor của bạn dùng tên khác.
3Dán API key và Base URL bên dưới.
4Chọn model gợi ý hoặc model khác đang active trong bảng giá.

Khối cấu hình mẫu

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Model nên thử

gpt-5.4
gemini-3.1-pro-high
kimi-k2.5
kimi-k2.6
deepseek-v4-flash
deepseek-v4-pro

Lưu ý

Cursor dùng kiểu OpenAI-compatible nên Base URL phải có `/v1`.
Nếu một model không chạy trong Cursor, hãy thử model OpenAI-compatible khác trong danh sách active.
Sau khi lưu, test bằng một prompt ngắn để xác nhận route `chat/completions` hoạt động.

Anthropic-compatible messages root URL

Claude Code

Claude Code nên cấu hình qua biến môi trường Anthropic, nhưng Base URL phải là root domain.

Cài đặt Claude Code

macOS / Linux / Windows (Node 18+): npm install -g @anthropic-ai/claude-code
Sau khi cài, chạy `claude` để xác nhận. Cấu hình được lưu tại `~/.claude/settings.json`.
Linux / macOS: `~/.claude/settings.json`
Windows: `%USERPROFILE%\.claude\settings.json`

Thông tin cần điền

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io
Model: claude-opus-4.6
Route: messages
Max tokens: 1024

Lưu ý

`ANTHROPIC_BASE_URL` không thêm `/v1`.
Ưu tiên model hỗ trợ route `messages`.
Nếu Claude Code bắt bạn login trước, hoàn tất flow login một lần rồi mở lại với env ở dưới.
Các request đi qua route `messages` phải gửi thêm trường `max_tokens`.

Terminal tạm thời

export ANTHROPIC_BASE_URL="https://api.xah.io"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_API_KEY"
claude --bare

PowerShell tạm thời

$env:ANTHROPIC_BASE_URL = "https://api.xah.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_API_KEY"
claude --bare

Cấu hình lưu cố định

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.xah.io",
        "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_API_KEY",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
    }
}

Model nên thử

claude-opus-4.6
gemini-3.1-pro-high
kimi-k2.5
kimi-k2.6
gpt-5.4
deepseek-v4-flash

OpenAI-compatible VS Code /v1

VS Code Extensions

Các extension trong VS Code thường ổn nhất khi dùng OpenAI-compatible mode với custom base URL.

Thông tin cần điền

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: claude-opus-4.6
Route: messages or chat/completions
Max tokens: 1024

Continue

name: CKEY API
version: 1.0.0
schema: v1
models:
  - name: claude-opus-4.6
    provider: anthropic
    model: claude-opus-4.6
    apiBase: https://api.xah.io/v1
    apiKey: sk-YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

Cline

Dùng provider OpenAI-compatible, Base URL có `/v1`, API key lấy từ Console.

Roo Code

Dùng provider OpenAI-compatible, Base URL có `/v1`, API key lấy từ Console.

Kilo Code

Dùng provider OpenAI-compatible, Base URL có `/v1`, API key lấy từ Console.

Model nên thử

gpt-5.4
gemini-3.1-pro-high
kimi-k2.5
kimi-k2.6
deepseek-v4-flash
deepseek-v4-pro

Lưu ý

Dùng provider OpenAI-compatible, Base URL có `/v1`, API key lấy từ Console.
Cursor dùng kiểu OpenAI-compatible nên Base URL phải có `/v1`.
Sau khi lưu, test bằng một prompt ngắn để xác nhận route `chat/completions` hoạt động.
Các request đi qua route `messages` phải gửi thêm trường `max_tokens`.

OpenAI-compatible ~/.codex /v1

Codex CLI

Codex extension cho VS Code hỗ trợ OpenAI-compatible API với custom base URL và API key.

Cài đặt Codex CLI

macOS / Linux / Windows (Node 18+): npm install -g @openai/codex
Sau khi cài, chạy `codex` để kiểm tra. Codex đọc auth từ `~/.codex/auth.json` và config từ `~/.codex/config.toml`.
Config: `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`)
Auth: `~/.codex/auth.json` (Windows: `%USERPROFILE%\.codex\auth.json`)

Thông tin cần điền

Provider: OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Các bước đề xuất

1Cài đặt Codex extension từ VS Code Marketplace.
2Mở VS Code Settings và tìm phần cấu hình Codex.
3Điền API Key và Base URL vào phần cấu hình Codex.
4Chọn model từ danh sách model đang active.

Nội dung `~/.codex/config.toml`

model = "gpt-5.4"
model_reasoning_effort = "high"
personality = "pragmatic"

openai_base_url = "https://api.xah.io/v1"

Nội dung `~/.codex/auth.json`

{
    "auth_mode": "apikey",
    "OPENAI_API_KEY": "sk-YOUR_API_KEY"
}

Model nên thử

gpt-5.4
gemini-3.1-pro-high
kimi-k2.5
kimi-k2.6
deepseek-v4-flash
deepseek-v4-pro

Lưu ý

Codex dùng OpenAI-compatible endpoint nên Base URL phải có /v1.
Sau khi cấu hình xong, reload VS Code để áp dụng thay đổi.
Test bằng cách mở một file code và thử chat với Codex.

OpenAI-compatible ~/.factory /v1

Factory Droid

Factory Droid là CLI assistant cho phép cấu hình custom model qua file `settings.json`.

Cài đặt Droid CLI

macOS / Linux: curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): iwr -useb https://app.factory.ai/cli/install.ps1 | iex
Sau khi cài, chạy `droid` để kiểm tra.
Linux / macOS: `~/.factory/settings.json`
Windows: `%USERPROFILE%\.factory\settings.json`

Thông tin cần điền

Provider: openai
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: gpt-5.4
Route: chat/completions

Lưu ý

Mỗi entry trong `customModels` cần `id` duy nhất, `index` tăng dần (0, 1, 2...).
Trường `provider` đặt là `openai` để Droid đi qua flow OpenAI-compatible.
Có thể thêm nhiều model bằng cách nhân bản object trong mảng và thay `model` + `id`.

Nội dung `~/.factory/settings.json`

{
    "customModels": [
        {
            "model": "gpt-5.4",
            "id": "custom:ckey-0",
            "index": 0,
            "baseUrl": "https://api.xah.io/v1",
            "apiKey": "sk-YOUR_API_KEY",
            "displayName": "gpt-5.4",
            "maxOutputTokens": 131072,
            "noImageSupport": false,
            "provider": "openai"
        }
    ]
}

Model nên thử

gpt-5.4
gemini-3.1-pro-high
kimi-k2.5
kimi-k2.6
deepseek-v4-flash
deepseek-v4-pro

Anthropic-compatible JSONC /v1

OpenCode

OpenCode có thể trỏ provider Anthropic về endpoint của bạn để dùng cùng API key.

Cài đặt OpenCode

Cài qua npm: npm install -g opencode-ai
Sau khi cài, chạy `opencode` để kiểm tra. Config nằm ở `~/.config/opencode/opencode.json` (hoặc `.jsonc`).

Đường dẫn config

Windows: `%USERPROFILE%\.config\opencode\opencode.json`
Linux / macOS: `~/.config/opencode/opencode.json`

Thông tin cần điền

API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: claude-opus-4.6
Route: messages
Max tokens: 1024

Khối cấu hình mẫu

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "ckey": {
            "npm": "@ai-sdk/openai-compatible",
            "options": {
                "baseURL": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY"
            },
            "models": {
                "claude-opus-4.6": {
                    "name": "claude-opus-4.6"
                },
                "gemini-3.1-pro-high": {
                    "name": "gemini-3.1-pro-high"
                },
                "kimi-k2.5": {
                    "name": "kimi-k2.5"
                },
                "kimi-k2.6": {
                    "name": "kimi-k2.6"
                },
                "gpt-5.4": {
                    "name": "gpt-5.4"
                },
                "deepseek-v4-flash": {
                    "name": "deepseek-v4-flash"
                }
            }
        }
    },
    "model": "ckey/claude-opus-4.6",
    "agent": {
        "explorer": {
            "description": "Fast explorer subagent for codebase exploration",
            "mode": "subagent",
            "model": "ckey/claude-opus-4.6"
        }
    }
}

Model nên thử

claude-opus-4.6
gemini-3.1-pro-high
kimi-k2.5
kimi-k2.6
gpt-5.4
deepseek-v4-flash

Lưu ý

OpenCode nên trỏ tới endpoint có `/v1`.
Ưu tiên model Claude đang active nếu workflow của bạn dùng anthropic-style tooling.
Nếu bạn đổi model ở chỗ khác trong config, giữ nguyên base URL và API key như bên dưới.
Các request đi qua route `messages` phải gửi thêm trường `max_tokens`.

OpenAI-compatible openclaw.json /v1

OpenClaw

OpenClaw có thể dùng provider OpenAI-compatible qua file `openclaw.json` với alias provider `ckey`.

Đường dẫn config

Project root: `./openclaw.json`
Windows: `%USERPROFILE%\.openclaw\openclaw.json`
Linux / macOS: `~/.openclaw/openclaw.json`

Thông tin cần điền

Provider: ckey / OpenAI-compatible
API Key: sk-YOUR_API_KEY
Base URL: https://api.xah.io/v1
Model: ckey/gpt-5.4
Route: chat/completions

Khối cấu hình mẫu

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "ckey/gpt-5.4"
            }
        }
    },
    "models": {
        "providers": {
            "ckey": {
                "baseUrl": "https://api.xah.io/v1",
                "apiKey": "sk-YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gpt-5.4",
                        "name": "gpt-5.4"
                    },
                    {
                        "id": "gemini-3.1-pro-high",
                        "name": "gemini-3.1-pro-high"
                    },
                    {
                        "id": "kimi-k2.5",
                        "name": "kimi-k2.5"
                    },
                    {
                        "id": "kimi-k2.6",
                        "name": "kimi-k2.6"
                    },
                    {
                        "id": "deepseek-v4-flash",
                        "name": "deepseek-v4-flash"
                    },
                    {
                        "id": "deepseek-v4-pro",
                        "name": "deepseek-v4-pro"
                    }
                ]
            }
        }
    }
}

Model nên thử

ckey/gpt-5.4
ckey/gemini-3.1-pro-high
ckey/kimi-k2.5
ckey/kimi-k2.6
ckey/deepseek-v4-flash
ckey/deepseek-v4-pro

Lưu ý

OpenClaw nên dùng `baseUrl` có `/v1`.
Giữ `api` là `openai-completions` để đi theo flow OpenAI-compatible.
Bạn có thể thêm hoặc bớt model trong danh sách, nhưng alias `ckey/` và API key nên giữ đúng như mẫu.

Thiết lập client theo từng công cụ

Chuẩn bị trước khi cấu hình

Quy tắc Base URL

SDK

Anthropic API request

Anthropic API streaming

OpenAI-compatible request

OpenAI-compatible streaming

Anthropic API request

Anthropic API streaming

OpenAI-compatible request

OpenAI-compatible streaming

Anthropic API request

Anthropic API streaming

OpenAI-compatible request

OpenAI-compatible streaming

Gemini (Google) request

Ollama request

Gửi ảnh local bằng base64

Gửi ảnh bằng URL

Base URL

Model

API Key

Cursor

Thông tin cần điền

Các bước đề xuất

Khối cấu hình mẫu

Model nên thử

Lưu ý

Claude Code

Cài đặt Claude Code

Thông tin cần điền

Lưu ý

Terminal tạm thời

PowerShell tạm thời

Cấu hình lưu cố định

Model nên thử

VS Code Extensions

Thông tin cần điền

Continue

Cline

Roo Code

Kilo Code

Model nên thử

Lưu ý

Codex CLI

Cài đặt Codex CLI

Thông tin cần điền

Các bước đề xuất

Nội dung `~/.codex/config.toml`

Nội dung `~/.codex/auth.json`

Model nên thử

Lưu ý

Factory Droid

Cài đặt Droid CLI

Thông tin cần điền

Lưu ý

Nội dung `~/.factory/settings.json`

Model nên thử

OpenCode

Cài đặt OpenCode

Đường dẫn config

Thông tin cần điền

Khối cấu hình mẫu

Model nên thử

Lưu ý

OpenClaw

Đường dẫn config

Thông tin cần điền

Khối cấu hình mẫu

Model nên thử

Lưu ý