AI STV
Tài liệu API
Bắt đầu

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.

01

Lấy API Key

Truy cập trang Lấy Key để nhận token miễn phí ngay lập tức.

02

Gọi API

Truyền token qua query parameter trong URL — đơn giản và nhanh chóng.

03

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.

Không cần SDK
Mọi API đều là HTTP GET đơn giản. Dùng được từ bất kỳ ngôn ngữ lập trình nào — JavaScript, Python, PHP, cURL...
Quick Start

Bắt Đầu Nhanh

Chạy thử ngay trong 30 giây với đoạn code JavaScript dưới đây.

JavaScript
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

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.

GET https://aistvchatbot80b.trongphucpython.workers.dev/api/ask?token=YOUR_TOKEN&message=...
Thay YOUR_TOKEN bằng token thực của bạn từ trang Lấy API Key.
⚠️
Bảo mật Token
Không chia sẻ token công khai. Nếu token bị lộ, hãy vào trang Lấy Key để tạo token mới.
API Chat

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.

♾️
Không giới hạn request
API Chat cho phép gửi không giới hạn số lượng tin nhắn — phù hợp cho mọi quy mô ứng dụng.

Endpoints

GET https://aistvchatbot80b.trongphucpython.workers.dev/api/ask
Gửi tin nhắn và nhận phản hồi từ AI.

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ụ

Request
https://aistvchatbot80b.trongphucpython.workers.dev/api/ask?token=YOUR_TOKEN&message=ai là người phát minh ra bóng đèn
Response · 200 OK
{

  "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."

}
Xử lý lỗi

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

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
ℹ️
Chat API không giới hạn
API Chat hoàn toàn miễn phí và không giới hạn số lượng request, phù hợp cho mọi nhu cầu tích hợp.