Bắt đầu nhanh

Tích hợp trong ba bước: đăng ký tài khoản → tạo API Key → điền Base URL và Key vào client.

Bước 1: Đăng ký tài khoảnSao chép liên kết neo

Mở aicentos.com, nhấn "Bắt đầu sử dụng" ở góc trên bên phải để vào trang đăng ký:

Điền tên người dùng và mật khẩu, tích đồng ý điều khoản dịch vụ rồi nhấn "Tạo tài khoản". Đăng ký được tặng ngay ¥1 tín dụng dùng thử, gọi API ngay mà không cần nạp tiền.

Bước 2: Tạo API KeySao chép liên kết neo

Sau khi đăng nhập vào Console, ở menu bên trái nhấn "API Key", rồi nhấn "Tạo API Key" ở góc trên bên phải:

Điền cấu hình trong hộp thoại rồi nhấn "Lưu thay đổi":

Sau khi tạo xong, key sẽ xuất hiện trong danh sách dạng sk-xxxxxxxxxxxx, mặc định được che bớt:

Danh sách key hỗ trợ tìm kiếm theo tên và key; có thể xem nhóm, hạn mức, mô hình khả dụng, giới hạn IP... và chỉnh sửa hoặc xóa bất cứ lúc nào:

Key chỉ hiển thị đầy đủ một lần duy nhất khi tạo, hãy sao chép và lưu giữ ngay. Đừng hard-code vào code frontend hay commit lên repo công khai.

Bước 3: Điền Base URL và Key vào clientSao chép liên kết neo

Chọn đúng Base URL trướcSao chép liên kết neo

Đây là bước dễ sai nhất — mỗi giao thức dùng một địa chỉ khác nhau:

Giao thức Anthropic chỉ điền địa chỉ gốc, đừng tự thêm /v1/messages, client sẽ tự nối.

Ở trang "API Key" trong Console, bạn cũng có thể xem và sao chép trực tiếp từ menu thả xuống "Địa chỉ API" ở góc trên bên phải:

Kiểm tra kết nốiSao chép liên kết neo

Chạy một request tối thiểu bằng curl để xác nhận Key và mạng hoạt động:

export AICENTOS_API_KEY="sk-key-của-bạn"

curl https://aicentos.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AICENTOS_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "messages": [
      {"role": "user", "content": "Giới thiệu bản thân trong một câu"}
    ]
  }'

Cũng có thể gọi danh sách mô hình trước. Chỉ cần trả về JSON là key và Base URL đều dùng được:

export AICENTOS_API_KEY="sk-key-của-bạn"

curl https://aicentos.com/v1/models \
  -H "Authorization: Bearer $AICENTOS_API_KEY"

Python (OpenAI SDK)Sao chép liên kết neo

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AICENTOS_API_KEY"],
    base_url="https://aicentos.com/v1",
)

resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Giới thiệu bản thân trong một câu"}],
)
print(resp.choices[0].message.content)

Node.js (OpenAI SDK)Sao chép liên kết neo

Ví dụ dùng cú pháp ESM, tên tệp phải là .mjs, hoặc thêm "type": "module" vào package.json:

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.AICENTOS_API_KEY,
  baseURL: 'https://aicentos.com/v1',
});

const resp = await client.chat.completions.create({
  model: 'gemini-3.8-flash',
  messages: [{ role: 'user', content: 'Giới thiệu bản thân trong một câu' }],
});

console.log(resp.choices[0].message.content);

Các client phổ biếnSao chép liên kết neo

• Tích hợp Claude Code — import một chạm bằng CC Switch hoặc cấu hình thủ công
• Tích hợp Codex — cấu hình bằng giao diện hoặc tự viết config.toml
• Tích hợp Cursor — tùy chỉnh cài đặt tương thích OpenAI
• Tích hợp Cherry Studio — thêm nhà cung cấp tương thích OpenAI

Nạp tiềnSao chép liên kết neo

Khi tín dụng tặng dùng hết, vào mục "Ví" ở menu bên trái của Console để nạp tiền:

Các mốc nạp và ưu đãi (nạp từ ¥100 trở lên có chiết khấu, số tiền thực trả thấp hơn mức nạp):

Cũng có thể nhập số tiền tùy ý, hoặc dùng mã đổi quà để nhận hạn mức.

• Phương thức thanh toán: Alipay, WeChat, chuyển khoản doanh nghiệp
• Hạn mức không bao giờ hết hạn, tính phí theo token tiêu thụ thực tế
• Có thưởng giới thiệu: đăng ký qua link giới thiệu thì cả hai bên đều nhận thưởng, có thể chuyển vào số dư bất cứ lúc nào

Xem mức sử dụngSao chép liên kết neo

Vào mục "Dashboard" ở menu bên trái của Console để xem chi tiết tiêu thụ:

Bạn sẽ thấy số dư hiện tại, tổng mức dùng, số request API và xu hướng gọi theo từng mô hình:

Thử ngay không cần viết codeSao chép liên kết neo

Trong mục "Chat" ở đầu Console có Playground tích hợp sẵn, chọn mô hình, gửi tin nhắn và tinh chỉnh prompt ngay trong lúc trò chuyện:

Bước tiếp theoSao chép liên kết neo

• Thử mô hình ngay trên trình duyệt trong Playground, không cần viết code
• Xem các mô hình hỗ trợ — biết hỗ trợ những LLM nào
• Đọc xử lý lỗi — xử lý lỗi 401, hết số dư...
• Tìm hiểu quy tắc tính phí — tính phí theo mức dùng và cảnh báo số dư