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
// API Chat cơ bản
const token = 'YOUR_TOKEN_HERE';
const message = 'Xin chào, bạn là ai?';
const apiUrl = `https://module-aistv.botzaloviptest-90b.workers.dev/api/ask?token=${token}&message=${encodeURIComponent(message)}`;

async function sendMessage() {
  try {
    const response = await fetch(apiUrl);
    const data = await response.json();
    console.log('AI Response:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
}

// Sử dụng
sendMessage();

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://module-aistv.botzaloviptest-90b.workers.dev/api/ask?token=YOUR_TOKEN&message=your_message
GET https://module-aistv.botzaloviptest-90b.workers.dev/api/ask?token=YOUR_TOKEN&message=your_message

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://module-aistv.botzaloviptest-90b.workers.dev/api/ask?token=TOKEN&message=CÂU_HỎI

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://module-aistv.botzaloviptest-90b.workers.dev/api/ask?token=abc123&message=Giải thích về AI cho người mới bắt đầu
Response Example
{
  "response": "AI (Trí tuệ nhân tạo) là lĩnh vực khoa học máy tính...",
  "status": "success"
}

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://module-aistv.botzaloviptest-90b.workers.dev/api/image?token=TOKEN&prompt=MIÊU_TẢ_ẢNH

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://module-aistv.botzaloviptest-90b.workers.dev/api/image?token=abc123&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"
}

API Check Token

Kiểm tra tính hợp lệ của token API.

Endpoints

GET https://module-aistv.botzaloviptest-90b.workers.dev/api/check?token=YOUR_TOKEN

Kiểm tra token có hợp lệ hay không

Request Example
https://module-aistv.botzaloviptest-90b.workers.dev/api/check?token=abc123
Response Example (Token hợp lệ)
{
  "valid": true,
  "message": "Token is valid"
}
Response Example (Token không hợp lệ)
{
  "valid": false,
  "message": "Invalid token"
}

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