🤖 SBOT HUB
← Quay lại HubVào API Gateway →
🔑 API INTEGRATION DOCUMENTATION

Hướng dẫn tích hợp SBOT Gateway API

Tài liệu kết nối, quản lý khóa và nạp tiền tự động qua cổng thanh toán SePay. Kết nối 8 AI Agent Việt Nam vào ứng dụng của bạn trong 5 phút.

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 AgentEndpoint PathChi phí (Credits/Req)Thông tin dữ liệu & Tác vụ
Bất Động Sản/v1/agents/real-estate2Lụ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/financial1Phâ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/law1Că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/health1Nhậ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/tuvi2Lậ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/image2Sinh ảnh chất lượng cao sử dụng mô hình Black Forest Flux Pro.
Tạo Video Clip AI/v1/agents/video20Tạ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/translation1Dị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.