Tài liệu Hướng dẫn

Hướng dẫn chi tiết sử dụng API Chat và Tạo Ảnh AI STV

Bắt Đầu với AI STV

AI STV cung cấp các API mạnh mẽ cho chat AI và tạo ảnh từ văn bản. Tài liệu này sẽ hướng dẫn bạn tích hợp các API vào ứng dụng của mình.

Bước 1: Lấy API Key

Truy cập trang Lấy API Key để nhận token miễn phí

Bước 2: Tích hợp API

Sử dụng token để gọi các endpoints qua HTTP requests

Bước 3: Khởi chạy

Kiểm tra và triển khai ứng dụng của bạn

Bắt Đầu Nhanh

Dưới đây là ví dụ cơ bản để bắt đầu sử dụng API Chat:

JavaScript Example
import readline from "readline";

const API_URL = "https://aistvchatbot80b.trongphucpython.workers.dev/api/ask";
const TOKEN = "Token"; // 🔴 thay token của bạn

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});

console.log("🤖 AI STV Chat");
console.log("Gõ 'exit' để thoát\n");

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 || "API lỗi\n");
      return;
    }

    console.log(`AI: ${data.answer}\n`);
  } catch (err) {
    console.log("❌ Không kết nối được API\n");
  }
}

function chatLoop() {
  rl.question("Bạn: ", async (input) => {
    if (input.trim().toLowerCase() === "exit") {
      console.log("👋 Tạm biệt!");
      rl.close();
      process.exit(0);
    }

    if (!input.trim()) {
      chatLoop();
      return;
    }

    await askAI(input);
    chatLoop(); // lặp tiếp
  });
}

chatLoop();

Xác thực API

Tất cả các API requests đều cần xác thực qua Token. Gửi token dưới dạng query parameter trong URL.

Authentication Method
https://aistvchatbot80b.trongphucpython.workers.dev/api/ask?token=Token&message=ASK
GET https://aistvchatbot80b.trongphucpython.workers.dev/api/ask?token=Token&message=ASK

Tham số:

token: YOUR_TOKEN (bắt buộc)
message: Nội dung tin nhắn (bắt buộc)

API Chat

API Chat cho phép bạn tích hợp khả năng trò chuyện thông minh vào ứng dụng của mình. API chat không giới hạn số lượng request.

Endpoints

GET https://aistvchatbot80b.trongphucpython.workers.dev/api/ask?token=Token&message=ASK

Gửi tin nhắn đến AI và nhận phản hồi

Tham số

Tham số Kiểu Bắt buộc Mô tả
token string * Token xác thực API
message string * Nội dung tin nhắn cần gửi

Ví dụ

Request Example
https://aistvchatbot80b.trongphucpython.workers.dev/api/ask?token=1272677&message=ai là người phát minh ra bóng đèn
Response Example
{
  "status": "success",
  "answer": "Bóng đèn được phát minh bởi Thomas Edison, một nhà phát minh và sáng kiến của Mỹ. Ông đã thực hiện nhiều đổi mới trong lĩnh vực điện, và bóng đèn được coi là một trong những phát minh quan trọng nhất của ông.\n\nTuy nhiên, việc phát minh bóng đèn không phải là của Edison riêng. Trước Edison, đã có nhiều người khác đã nghiên cứu và phát triển các loại đèn dẫn điện, bao gồm cả Humphry Davy, James Bowman Lindsay và Joseph Swan.\n\nEdison đã phát triển loại đèn dây tóc được sử dụng rộng rãi ngày nay, và ông đã tạo ra chiếc đèn điện đầu tiên sử dụng dây tóc đã được phân phối vào năm 1879. Edison đã làm việc chăm chỉ để cải thiện thiết kế của đèn này, và cuối cùng đã tạo ra một loại bóng đèn có hiệu suất cao hơn và dễ sử dụng hơn.\n\nVì vậy, mặc dù Edison không phải là người đầu tiên phát minh bóng đèn, ông đã đóng góp lớn vào sự phát triển và phổ biến của nó. Ông đã giúp tạo ra đèn điện trở nên phổ biến và thay thế cho các loại đèn khác như đèn dầu và đèn nến."
}

API Tạo Ảnh

Tạo ảnh từ mô tả văn bản với nhiều phong cách khác nhau.

Giới hạn sử dụng

API tạo ảnh có giới hạn 100 request. Vui lòng sử dụng hợp lý.

Endpoints

GET https://aistvchatbot80b.trongphucpython.workers.dev/api/image?token=Token&prompt=Miêu tả

Tạo ảnh từ prompt văn bản

Tham số

Tham số Kiểu Bắt buộc Mô tả
token string * Token xác thực API
prompt string * Mô tả ảnh cần tạo

Ví dụ

Request Example
https://aistvchatbot80b.trongphucpython.workers.dev/api/image?token=Token&prompt=Một chú mèo anime dễ thương đang đọc sách trong thư viện
Response Example
{
  "image_url": "https://example.com/generated-image.jpg",
  "prompt": "Một chú mèo anime dễ thương đang đọc sách trong thư viện",
  "status": "success"
}

Mã Lỗi

Mã lỗi Mô tả Giải pháp
401 Unauthorized - Token không hợp lệ Kiểm tra lại token
429 Too Many Requests - Vượt quá giới hạn (API ảnh) Giảm tần suất requests hoặc đợi reset
500 Internal Server Error Thử lại sau hoặc liên hệ support

Giới hạn Request

Hệ thống áp dụng các giới hạn sau để đảm bảo chất lượng dịch vụ:

  • API Chat: Không giới hạn số lượng request
  • API Tạo Ảnh: Giới hạn 100 request/địa chỉ IP
  • API Check Token: Không giới hạn số lượng request

Giới hạn được tính theo địa chỉ IP và sẽ được reset sau mỗi 24 giờ.