Hướng dẫn tích hợp OpenAI Token API: 3 dòng code chuyển từ OpenAI SDK sang cổng thống nhất TonBo

3 dòng code, chuyển OpenAI SDK sang cổng thống nhất TonBo

Token API của TonBo hoàn toàn tương thích với giao thức endpoint OpenAI — code Python / Node / Go đang chạy OpenAI SDK của bạn chỉ cần sửa 3 dòng cấu hình base_url và api_key là có thể chuyển sang cổng thống nhất TonBo, một lần gọi kết nối GPT-5, Claude 4.5 Opus, Gemini 2.5 Pro, Grok 4, Llama 4 và 50+ mô hình lớn khác. Không cần viết lớp thích ứng riêng cho từng nhà cung cấp dịch vụ, không cần duy trì 5 API Key, hóa đơn cũng chỉ có một tờ.

Bước 1: Lấy Token và base_url

Gói đăng ký bao gồm hạn mức Token hàng tháng

Mỗi gói đăng ký của TonBo đều bao gồm hạn mức Token hàng tháng, bao gồm mô hình hàng đầu, mô hình nhanh, mô hình trọng số mã nguồn mở ba cấp. Gói Basic mỗi tháng 5M tokens, gói Pro mỗi tháng 20M, gói Team mỗi tháng 50M có thể phân bổ cho 5 tài khoản. Token API và không gian làm việc AI Conversation dùng chung cùng một hạn mức — token tiêu thụ trong cuộc trò chuyện và token tiêu thụ bởi lệnh gọi code đều được trừ từ một hóa đơn.

Bảng điều khiển tạo API Key một cú nhấp

Đăng nhập bảng điều khiển TonBo, vào "Nhà phát triển → Token API", nhấp "Tạo API Key" để lấy một chuỗi khóa bắt đầu bằng sk-tb-. base_url cố định là https://api.tonboai.com/v1. Ghi lại hai giá trị này, tiếp theo dán vào cấu hình SDK.

Bước 2: Sửa 3 dòng code tích hợp

Python: openai SDK

Cách khởi tạo SDK Python chính thức như sau, thay api_key và base_url bằng giá trị của TonBo:

from openai import OpenAI

client = OpenAI(
    api_key="sk-tb-xxxxxxxxxx",
    base_url="https://api.tonboai.com/v1",
)

resp = client.chat.completions.create(
    model="claude-4-5-sonnet",
    messages=[{"role": "user", "content": "Viết một đoạn code sắp xếp nhanh"}],
)
print(resp.choices[0].message.content)

Node.js: openai SDK

Phía Node cũng chỉ sửa hai dòng:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-tb-xxxxxxxxxx",
  baseURL: "https://api.tonboai.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Cho tôi ba phương án khóa phân tán Redis" }],
});
console.log(resp.choices[0].message.content);

Go: go-openai

sashabaranov/go-openai là tiêu chuẩn thực tế của hệ sinh thái Go, cũng có thể chuyển đổi trực tiếp:

import openai "github.com/sashabaranov/go-openai"

cfg := openai.DefaultConfig("sk-tb-xxxxxxxxxx")
cfg.BaseURL = "https://api.tonboai.com/v1"
client := openai.NewClientWithConfig(cfg)

resp, _ := client.CreateChatCompletion(ctx, openai.ChatCompletionRequest{
    Model: "gemini-2-5-pro",
    Messages: []openai.ChatCompletionMessage{
        {Role: openai.ChatMessageRoleUser, Content: "Giải thích định lý CAP"},
    },
})

Bước 3: Chuyển đổi mô hình chỉ sửa một tham số model

Tất cả 50+ mô hình lớn dưới cổng thống nhất TonBo sử dụng cùng một giao thức Chat Completions, chuyển đổi mô hình chỉ cần sửa một dòng trường model:

• gpt-5 — Suy luận hàng đầu OpenAI + Agent
• gpt-4o — Đa phương thức OpenAI + luồng chi phí thấp
• claude-4-5-opus — Sinh mã ngữ cảnh dài Anthropic
• claude-4-5-sonnet — Mô hình Agent mặc định thông lượng cao Anthropic
• gemini-2-5-pro — Ngữ cảnh siêu dài Google + đa phương thức
• grok-4 — Suy luận xAI + tìm kiếm thời gian thực
• llama-4-maverick — Hàng đầu trọng số mã nguồn mở Meta
• deepseek-v3-2 — Trọng số mã nguồn mở code và suy luận DeepSeek
• qwen-3-max — Mô hình tiếng Trung gốc mã nguồn mở Alibaba

Danh sách đầy đủ xem trang thư mục mô hình trong bảng điều khiển, bất cứ khi nào thêm mới hoặc điều chỉnh mô hình theo cấp sẽ tự động xuất hiện dưới cùng một API, phía client không cần nâng cấp theo.

So sánh phổ biến: TonBo Token API vs kết nối trực tiếp API chính thức

Khía cạnh	TonBo Token API	Kết nối trực tiếp API chính thức
Tương thích SDK	100% tương thích OpenAI, chỉ sửa base_url	Mỗi nhà có SDK riêng
Chuyển đổi đa mô hình	Chỉ sửa tham số model	Cần chuyển SDK, làm lại lớp thích ứng
Quản lý API Key	Một cái	N cái
Hóa đơn	Theo gói đăng ký + vượt quá theo lượng	Hóa đơn độc lập cho mỗi nhà
Kênh mạng	Bao gồm đường hầm bảo mật AI, độ trễ thấp ổn định	Tùy thuộc mạng cục bộ
Tốc độ có hiệu lực	Sửa 3 dòng xong là có hiệu lực ngay	Mỗi lần thêm một nhà cần ký hợp đồng lại

Tích hợp một lần, 50+ mô hình lớn tùy ý chuyển đổi

Token API của TonBo là khả năng tiêu chuẩn của gói đăng ký, dùng chung hóa đơn và hạn mức với đường hầm bảo mật AI, không gian làm việc AI Conversation thống nhất. Xem tài liệu Token API hoặc Đăng ký tài khoản TonBo ngay, 3 dòng code là có thể chạy yêu cầu đầu tiên.