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:
// 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.
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
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ụ
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": "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
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ụ
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
{
"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
Kiểm tra token có hợp lệ hay không
https://module-aistv.botzaloviptest-90b.workers.dev/api/check?token=abc123
{
"valid": true,
"message": "Token is valid"
}
{
"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ờ.