1Quy trình tạo API Key đối tác B2B
👤
Bước 1: Đăng nhập Portal API
Truy cập sbot.io.vn/gateway. Đăng nhập bằng tài khoản Google hoặc tài khoản Email của bạn. Hệ thống tặng ngay **5.000 credits miễn phí** cho ví mới.
🔑
Bước 2: Sinh API Key
Vào mục **API Keys** trên menu, bấm **Tạo Key mới**. Hệ thống sẽ hiển thị khóa ngẫu nhiên dạng
sbot_sk_.... Hãy sao chép ngay lập tức vì khóa chỉ hiện đầy đủ 1 lần duy nhất để bảo mật.💳
Bước 3: Nạp Credits tự động (Pay-as-you-go)
Hệ thống thanh toán qua SePay QR. Quy đổi: **10.000đ VND = 1.000 credits**. Chuyển khoản đúng cú pháp và số tiền, credits sẽ được cộng vào tài khoản tự động trong vòng 10-30 giây.
2Bảng giá dịch vụ AI Agent qua Gateway API
*Credits được trừ tự động theo số lượt gọi thành công. Không tính phí cho các yêu cầu lỗi hoặc thất bại.*
| Tên AI Agent | Endpoint Path | Chi phí (Credits/Req) | Thông tin dữ liệu & Tác vụ |
|---|---|---|---|
| Bất Động Sản | /v1/agents/real-estate | 2 | Lục soát dữ liệu 3.5M tin đăng nhà đất thực tế & phân tích thị trường AI. |
| Phân Tích Tài Chính | /v1/agents/financial | 1 | Phân tích tài chính, kết quả kinh doanh 1.491 mã chứng khoán. |
| Tư Vấn Pháp Luật | /v1/agents/law | 1 | Căn cứ các bộ luật VN: Dân sự, Đất đai, Hình sự, Doanh nghiệp. |
| Y Tế Cộng Đồng (Cô Năm) | /v1/agents/health | 1 | Nhận diện triệu chứng y học lâm sàng từ 56K dữ liệu VN. |
| Lá Số Tử Vi | /v1/agents/tuvi | 2 | Lập & phân tích lá số tử vi đẩu số 12 cung, 140+ sao chi tiết. |
| Tạo Ảnh Nghệ Thuật AI | /v1/agents/image | 2 | Sinh ảnh chất lượng cao sử dụng mô hình Black Forest Flux Pro. |
| Tạo Video Clip AI | /v1/agents/video | 20 | Tạo video ngắn chuyển động chất lượng cao (Text to Video). |
| Dịch Thuật Chuyên Ngành | /v1/agents/translation | 1 | Dịch song song 10 ngôn ngữ chuyên ngành kỹ thuật, tài chính, y tế. |
3Hướng dẫn gọi API kết nối
Base URL: https://gateway.sbot.io.vn. Mọi yêu cầu gọi bắt buộc đính kèm Header:
x-sbot-api-key: sbot_sk_your_api_key_here
Content-Type: application/json
# Gọi Agent Bất Động Sản (Real Estate)
curl -X POST https://gateway.sbot.io.vn/v1/agents/real-estate \
-H "x-sbot-api-key: sbot_sk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"question": "Giá đất nền tại Quận 9 TP.HCM hiện nay trung bình là bao nhiêu?",
"history": []
}'
# Gọi Agent Phân Tích Tài Chính (Financial)
curl -X POST https://gateway.sbot.io.vn/v1/agents/financial \
-H "x-sbot-api-key: sbot_sk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"question": "Phân tích tình hình tài chính của mã cổ phiếu FPT năm 2024",
"history": []
}'4Hỗ trợ xử lý lỗi (Troubleshooting)
🔴 Lỗi 401 Unauthorized
API Key truyền vào không chính xác hoặc đã bị admin vô hiệu hóa. Hãy kiểm tra lại header
x-sbot-api-key.🟠 Lỗi 402 Payment Required
Số dư ví của bạn không đủ để thực hiện lượt gọi này. Hãy đăng nhập cổng
sbot.io.vn/gateway để quét mã nạp thêm credits.🔵 Lỗi 404 Not Found
Đường dẫn (path) gọi API sai hoặc Agent đó chưa được khai báo trên hệ thống. Kiểm tra chính xác URL trong bảng danh sách.
⚪ Lỗi 500 Server Error
Hệ thống AI ở backend tạm thời quá tải hoặc mất kết nối. Yêu cầu này sẽ không trừ credits ví của bạn. Vui lòng thử lại sau.