Chào mừng đến với AI STV API
AI STV cung cấp Chat API để tích hợp trò chuyện thông minh vào ứng dụng của bạn. Tất cả đều được truy cập qua HTTP đơn giản — không cần SDK.
Gọi API
Truyền token qua query parameter trong URL — đơn giản và nhanh chóng.
Triển khai
Tích hợp vào ứng dụng web, mobile hoặc bất kỳ nền tảng nào hỗ trợ HTTP.
Bắt Đầu Nhanh
Chạy thử ngay trong 30 giây với đoạn code JavaScript dưới đây.
import readline from "readline"; const API_URL = "https://aistvchatbot80b.trongphucpython.workers.dev/api/ask"; const TOKEN = "YOUR_TOKEN"; // 🔑 Thay bằng token của bạn const rl = readline.createInterface({ input: process.stdin, output: process.stdout }); async function askAI(message) { const url = new URL(API_URL); url.searchParams.set("token", TOKEN); url.searchParams.set("message", message); try { const res = await fetch(url); const data = await res.json(); if (!res.ok || data.error) { console.log("❌ Lỗi:", data.error); return; } console.log(`🤖 AI: ${data.answer}`); } catch { console.log("❌ Không kết nối được API"); } } function chat() { rl.question("Bạn: ", async (msg) => { if (msg.trim().toLowerCase() === "exit") { rl.close(); return; } if (msg.trim()) await askAI(msg); chat(); }); } chat();
Xác Thực API
Mọi request đều yêu cầu token hợp lệ. Token được truyền dưới dạng query parameter trực tiếp trong URL.
YOUR_TOKEN bằng token thực của bạn từ trang Lấy API Key.Chat API
Tích hợp trí tuệ nhân tạo vào ứng dụng của bạn. Gửi câu hỏi và nhận phản hồi tự nhiên, thông minh ngay lập tức. Không giới hạn số lượng request.
Endpoints
Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| token | string | Bắt buộc | Token xác thực API của bạn |
| message | string | Bắt buộc | Nội dung câu hỏi hoặc tin nhắn cần gửi đến AI |
Ví dụ
https://aistvchatbot80b.trongphucpython.workers.dev/api/ask?token=YOUR_TOKEN&message=ai là người phát minh ra bóng đèn
{
"status": "success",
"answer": "Bóng đèn được phát minh bởi Thomas Edison, một nhà phát minh người Mỹ. Ông đã phát triển loại đèn dây tóc được sử dụng rộng rãi ngày nay vào năm 1879."
}Mã Lỗi
Khi có lỗi xảy ra, API trả về HTTP status code và thông báo tương ứng. Dưới đây là các mã lỗi phổ biến.
| Mã HTTP | Mô tả | Cách xử lý |
|---|---|---|
| 401 | Token không hợp lệ hoặc hết hạn | Kiểm tra lại token. Lấy token mới tại trang Lấy Key |
| 500 | Lỗi máy chủ nội bộ | Thử lại sau vài giây. Nếu lỗi liên tục hãy liên hệ support |
Giới Hạn Request
Hệ thống áp dụng giới hạn để đảm bảo chất lượng dịch vụ ổn định cho tất cả người dùng.
| API | Giới hạn | Reset |
|---|---|---|
| Chat API | Không giới hạn | — |
| Check Token API | Không giới hạn | — |