Tài liệu API

Trang này tương thích hoàn toàn với protocol gốc của OpenAI và Anthropic — trỏ SDK hiện có vào Base URL của chúng tôi là xong.

Thông tin cơ bản

Protocol tương thích OpenAI

Gọi theo protocol ChatCompletions chính thức của OpenAI. Dùng tên model chính thức của từng nhà cung cấp — chúng tôi tự động định tuyến đến upstream tương ứng.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxx",
    base_url="https://aiproxynode.com/v1",
)

# Gọi bất kỳ model nào qua protocol OpenAI
for model in ["claude-sonnet-4-6", "claude-haiku-4-5", "deepseek-chat", "deepseek-reasoner"]:
    resp = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "Hi"}],
    )
    print(model, "->", resp.choices[0].message.content)

Đa phương thức (đầu vào hình ảnh)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Trong ảnh viết gì?"},
            {"type": "image_url", "image_url": {"url": "https://example.com/x.png"}},
        ],
    }],
)

Function Calling / Tools

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Lấy thời tiết của một thành phố",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Thời tiết Hà Nội thế nào?"}],
    tools=tools,
)

API Claude gốc

Khi dùng SDK Anthropic chính thức, chỉ cần đổi base_url thành https://aiproxynode.com.

import anthropic

client = anthropic.Anthropic(
    api_key="sk-xxxxxx",
    base_url="https://aiproxynode.com",
)

resp = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hi"}],
)
print(resp.content[0].text)

Cài đặt IDE Client (Claude Code / Cline / Cursor / Continue)

⚡ Script cài đặt 1 chạm

Không muốn chép biến môi trường bằng tay? Tải script tương ứng — script sẽ tự sao lưu cấu hình hiện tại và ghi cấu hình mới.

Cách dùng: chuột phải vào link → Lưu link → Windows chuột phải vào .ps1 và Run with PowerShell; macOS chạy bash setup-xxx.sh trong Terminal.

Script sẽ hỏi token rồi ghi cấu hình; KHÔNG kiểm tra kết nối online. Sau khi chạy, gửi một tin nhắn thử trong client để xác nhận.

Hầu hết AI assistant trong IDE hỗ trợ trỏ tới endpoint tương thích Anthropic tùy chỉnh thông qua biến môi trường hoặc cài đặt. Dưới đây là cách cài cho các client phổ biến.

Claude Code (Tiện ích VSCode / CLI)

Claude Code chính thức của Anthropic chuyển sang trang này thông qua hai biến môi trường — ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN:

# Toàn hệ thống, lưu vĩnh viễn (khuyến nghị)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aiproxynode.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxx", "User")
# Khởi động lại VSCode để có hiệu lực

# Thêm vào ~/.zshrc hoặc ~/.bashrc
export ANTHROPIC_BASE_URL="https://aiproxynode.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"
# Khởi động lại VSCode / Terminal để có hiệu lực

Đối với chuyển đổi tạm thời chỉ cho một phiên:

ANTHROPIC_BASE_URL=https://aiproxynode.com \
ANTHROPIC_AUTH_TOKEN=sk-xxxxxx \
claude --model claude-sonnet-4-6

Cline / Roo Code (Tiện ích VSCode)

1. Mở cài đặt Cline (biểu tượng bánh răng)
2. Đặt API Provider là Anthropic
3. Tích Use custom base URL, điền https://aiproxynode.com
4. Đặt API Key là token sk-xxxxxx của bạn
5. Chọn Model như claude-sonnet-4-6 hoặc claude-opus-4-7

Cursor

Cursor không expose cài đặt Anthropic Base URL; mọi tích hợp bên thứ ba đều đi qua protocol tương thích OpenAI. Trong Cursor Settings → Models:

1. Tắt toggle Anthropic API Key. Nếu trước đó đã bật, hãy tắt và xóa input Anthropic Key.
2. Mở rộng phần API Keys → bật OpenAI API Key → dán token sk-xxxxxx của bạn
3. Bật Override OpenAI Base URL → đặt URL là https://aiproxynode.com/v1
4. Cuộn lên danh sách Models, tìm input Add or search model, và thêm các dòng dưới đây (bấm Enter sau mỗi dòng):

   Alias để nhập	Model thực được dùng	Trường hợp dùng
   aiproxy/sonnet	claude-sonnet-4-6	Code hàng ngày, cân bằng chi phí/chất lượng (khuyến nghị)
   aiproxy/haiku	claude-haiku-4-5	Tác vụ nhẹ, rẻ nhất
   aiproxy/opus	claude-opus-4-7	Suy luận nặng, tác vụ phức tạp

   Dùng alias thay vì tên chính thức để vượt qua định tuyến "ưu tiên built-in" của Cursor. Quản trị trang phải map các alias này tới model thực trong Channels → Model Redirect của new-api trước; người dùng thông thường có thể chép alias trên nguyên xi, không cần cài đặt gì.
5. Bật toggle ON cho mọi model vừa thêm. Chỉ thêm thôi không expose chúng vào dropdown chat.
6. Mở phiên chat/Agent bất kỳ, bấm bộ chọn model ở góc dưới bên trái và chọn aiproxy/sonnet (hoặc khác) bạn vừa thêm. Không chọn thủ công thì Cursor mặc định Auto = model built-in, request sẽ không đến trang này.

Continue (Tiện ích VSCode / JetBrains)

Sửa ~/.continue/config.json và thêm vào mảng models:

{
  "models": [
    {
      "title": "Claude Sonnet 4.6 via AiProxyNode",
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "apiKey": "sk-xxxxxx",
      "apiBase": "https://aiproxynode.com"
    }
  ]
}

Streaming

Mọi model đều hỗ trợ streaming (Server-Sent Events):

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Viết một bài thơ ngắn"}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

curl https://aiproxynode.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Viết thơ"}],
    "stream": true
  }'

Danh sách Model

Đối với model phổ biến, chỉ cần dùng tên chính thức. Danh sách đầy đủ và bảng giá tại trang chính → Models.

OpenAI

Kênh OpenAI hiện chưa được kích hoạt. Chúng tôi khuyến nghị dùng claude-sonnet-4-6 (tương đương GPT-4o) hoặc deepseek-chat (hiệu năng/giá tốt) thay thế. Phần này sẽ được cập nhật khi kênh OpenAI online.

Anthropic Claude

• claude-haiku-4-5 — rẻ nhất, phù hợp cho gọi nhẹ với khối lượng lớn
• claude-sonnet-4-5 · claude-sonnet-4-6 — cân bằng chi phí và chất lượng
• claude-opus-4-5 · claude-opus-4-6 · claude-opus-4-7 — suy luận mạnh nhất

Khuyến nghị dùng các alias trên. Dạng có ngày của các phiên bản đang hoạt động (claude-haiku-4-5-20251001 / claude-sonnet-4-5-20250929 / claude-opus-4-5-20251101) cũng hoạt động — SDK Anthropic chính thức và Claude Code map alias sang tên có ngày bên trong, bạn không cần chỉ định thủ công. Tên có ngày đã ngừng hoạt động (ví dụ claude-sonnet-4-20250514) sẽ trả 503 model_not_found.

DeepSeek

• deepseek-chat — chat và code thông dụng (V4 mới nhất)
• deepseek-reasoner — suy luận chuỗi dài / toán / tác vụ khó
• deepseek-coder — alias chuyên cho code

Kênh Moonshot / Doubao / Qwen / GLM / Gemini / OpenAI hiện chưa được kích hoạt — gọi các tên model đó sẽ trả 503 No available channel. Danh sách model có sẵn đầy đủ và bảng giá ở trang Models của site chính.

Mã lỗi