§01

Bắt đầu trong ba bước

Đăng ký bằng email hoặc tài khoản Google. Đăng ký miễn phí
Nạp tiền trong bảng điều khiển, rồi tạo một API Key.
Đổi base URL trong chương trình sang địa chỉ của chúng tôi, điền API Key, model điền tên trên trang mô hình. Xem mô hình

§02

Địa chỉ và xác thực

Định dạng OpenAI (đa số công cụ và SDK) dùng địa chỉ có /v1:

https://api.macloudai.com/v1

Định dạng Anthropic (Anthropic SDK, Claude Code) dùng địa chỉ không có /v1:

https://api.macloudai.com

Gửi API Key trong header Authorization: Bearer sk-... (định dạng Anthropic cũng nhận x-api-key). Key tiêu chính số dư của bạn, đừng đặt trong code frontend hay kho code công khai.

§03

OpenAI SDK

from openai import OpenAI

client = OpenAI(base_url="https://api.macloudai.com/v1", api_key="sk-...")
r = client.chat.completions.create(
    model="gem-3.8-flash",
    messages=[{"role": "user", "content": "Halo"}],
)
print(r.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.macloudai.com/v1", apiKey: process.env.API_KEY });
const r = await client.chat.completions.create({
  model: "gem-3.8-flash",
  messages: [{ role: "user", content: "Halo" }],
});
console.log(r.choices[0].message.content);

curl https://api.macloudai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gem-3.8-flash", "messages": [{"role": "user", "content": "Halo"}], "stream": true}'

Hỗ trợ stream (trả kết quả dạng luồng).

§04

Anthropic SDK

import anthropic

client = anthropic.Anthropic(base_url="https://api.macloudai.com", api_key="sk-...")
r = client.messages.create(
    model="hk-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Halo"}],
)
print(r.content[0].text)

Địa chỉ định dạng Anthropic không có /v1.

§05

Claude Code

Đặt các biến môi trường này trong terminal rồi chạy claude (muốn dùng lâu dài thì ghi vào ~/.zshrc hoặc ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
claude

§06

Cursor

Mở Settings → Models.
Điền Key vào OpenAI API Key, bật Override OpenAI Base URL và điền https://api.macloudai.com/v1.
Bấm + Add model, điền tên mô hình trên trang mô hình, rồi bấm Verify.

§07

Cherry Studio

Cài đặt → Dịch vụ mô hình → Thêm, chọn loại OpenAI (mô hình Claude cũng có thể chọn Anthropic).
API Host điền https://api.macloudai.com, API Key điền Key của bạn.
Bấm “Quản lý” hoặc “Thêm”, điền tên mô hình trên trang mô hình.

§08

LobeChat

Trong Cài đặt → Mô hình ngôn ngữ → OpenAI, điền API Key và địa chỉ proxy API https://api.macloudai.com/v1. Nếu tự triển khai, đặt biến môi trường:

OPENAI_API_KEY=sk-...
OPENAI_PROXY_URL=https://api.macloudai.com/v1

§09

Tính phí và mã lỗi

Mỗi lần gọi trừ vào số dư theo số token đầu vào và đầu ra, giá xem trên trang mô hình. Hết số dư thì yêu cầu bị từ chối, nạp tiền xong dùng lại ngay.

Mã	Ý nghĩa
401	API Key sai, đã bị tắt hoặc đã bị xóa.
403	Không đủ số dư, hoặc Key này không được dùng mô hình đó.
404	Sai tên mô hình. Hãy điền đúng tên trên trang mô hình.
429	Gửi yêu cầu quá nhanh. Đợi một chút rồi thử lại.
5xx	Mô hình phía nhà cung cấp đang lỗi tạm thời. Thử lại sau ít phút.