Best LLM API Tài liệu
Hướng dẫn bắt đầu: Tích hợp trực tiếp
Tích hợp API LLM không kiểm duyệt của chúng tôi vào ứng dụng của bạn bằng cách thay đổi base URL và khóa API trong cơ sở mã tương thích OpenAI hiện có của bạn.
Yêu cầu tiên quyết
Trước khi thực hiện yêu cầu đầu tiên, hãy đảm bảo bạn có một khóa API hợp lệ. Đăng ký tại trang Lấy khóa API để nhận khóa của bạn ngay lập tức. Không cần thẻ tín dụng cho bản dùng thử ban đầu. Bạn sẽ cần môi trường ngôn ngữ lập trình được hỗ trợ (Python 3.8+ hoặc Node.js 18+) và SDK OpenAI chính thức được cài đặt trong dự án của bạn.
Dịch vụ của chúng tôi đóng vai trò là giải pháp thay thế trực tiếp cho các endpoint chat-completions tiêu chuẩn. Bạn không cần cài đặt thư viện khách hàng tùy chỉnh; SDK OpenAI tiêu chuẩn xử lý giao thức truyền thông, bao gồm truyền phát và gọi công cụ, miễn là bạn cấu hình base URL chính xác.
Xác thực
Xác thực được xử lý qua tiêu đề Authorization. Hãy chuyển khóa API của bạn dưới dạng token Bearer. Nếu khóa không hợp lệ hoặc đã hết hạn, API sẽ trả về lỗi 401 Unauthorized. Nếu số dư tài khoản của bạn không đủ, bạn sẽ nhận được lỗi 402 Payment Required. Hãy thêm khóa của bạn vào các biến môi trường hoặc tệp cấu hình để tránh mã hóa cứng thông tin xác thực.
- Tiêu đề:
Authorization: Bearer YOUR_API_KEY - URL cơ sở:
https://api.bestllmapi.com/v1
Giữ khóa của bạn an toàn. Bạn có thể tạo lại khóa bất cứ lúc nào từ bảng điều khiển của mình, điều này sẽ vô hiệu hóa ngay lập tức khóa trước đó.
Hoàn thiện trò chuyện cơ bản
Gửi yêu cầu POST đến /v1/chat/completions với ID model là uncensored và lịch sử tin nhắn của bạn. API trả về phản hồi văn bản. Endpoint này hỗ trợ các cấu trúc JSON tiêu chuẩn của OpenAI, giúp việc di chuyển từ các nhà cung cấp khác trở nên đơn giản.
Hãy đảm bảo bạn cấu trúc tin nhắn của mình đúng cách với các vai trò như system, user và assistant. Mô hình xử lý đầu vào và tạo ra phần hoàn thiện dựa trên ngữ cảnh prompt của bạn.
curl https://api.bestllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Phản hồi truyền phát (streaming)
Để có trải nghiệm người dùng theo thời gian thực, hãy bật chế độ truyền phát bằng cách đặt stream: true trong thân yêu cầu của bạn. API trả về luồng Sự kiện được gửi bởi máy chủ (SSE) chứa các đối tượng delta. Mỗi delta chứa một đoạn văn bản được tạo ra. Hãy xử lý các chunk này theo cách tăng dần để hiển thị văn bản khi nó được tạo, giảm độ trễ cảm nhận cho người dùng cuối.
Việc xử lý luồng giống hệt với giao thức truyền phát tiêu chuẩn của OpenAI. Bạn phải xử lý sự kiện hoàn tất luồng để biết khi nào quá trình tạo kết thúc.
from openai import OpenAI
client = OpenAI(base_url="https://api.bestllmapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Gọi hàm
Xác định các hàm trong thân yêu cầu của bạn bằng tham số tools. Mô hình có thể trả về một đối tượng gọi công cụ thay vì văn bản trực tiếp. Hãy phân tích cú pháp tên hàm và các đối số, thực thi hàm trong mã của bạn, sau đó gửi kết quả lại cho mô hình để có phản hồi cuối cùng. Điều này cho phép LLM của bạn tương tác với các API hoặc cơ sở dữ liệu bên ngoài một cách động.
Gọi hàm tuân theo lược đồ tiêu chuẩn của OpenAI. Hãy đảm bảo các định nghĩa hàm của bạn chính xác để cải thiện độ chính xác của mô hình trong việc chọn công cụ đúng và trích xuất các đối số.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestllmapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Giới hạn cửa sổ ngữ cảnh
Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token, bao gồm cả token prompt và token hoàn thiện. Hãy theo dõi việc sử dụng token của bạn để tránh vượt quá giới hạn này, điều này sẽ dẫn đến lỗi 400 Bad Request. Nếu bạn đạt đến giới hạn tốc độ 300 yêu cầu mỗi phút, bạn sẽ nhận được lỗi 429 Too Many Requests.
Triển khai backoff theo cấp số nhân cho các lần thử lại. Thân yêu cầu được giới hạn ở 8 MB. Đối với các cuộc trò chuyện dài, hãy cân nhắc tóm tắt các tin nhắn trước đó để duy trì trong ngân sách token trong khi vẫn giữ được ngữ cảnh.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Thông số kỹ thuật
Toàn bộ giới hạn và tính năng thực tế của API ở một nơi — hãy kiểm tra trước khi nạp tiền.
| Mục | Giá trị |
|---|---|
| Định dạng | tương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.bestllmapi.com/v1 |
| ID mô hình | uncensored |
| Gọi hàm | có — tools, tool_choice; phản hồi có tool_calls, kể cả khi streaming; kết quả gửi lại bằng role: tool |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Đầu ra tối đa | tối đa phần còn lại của cửa sổ 100.000 token; max_tokens tùy chọn (không giới hạn riêng) |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Kích thước yêu cầu | tối đa 8 MB |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Thưởng | +5% từ $50, +10% từ $100, +15% từ $200 |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $20 đến $500 |
| Giá | $0,15 cho 1 triệu token đầu vào · $0,50 cho 1 triệu token đầu ra |
| Tính phí | tín dụng trả trước theo mức dùng thực tế; lỗi và từ chối miễn phí |
| Dùng thử miễn phí | $0,50 trong 7 ngày, không cần thẻ · Khóa dùng thử: 2 yêu cầu song song, 60 yêu cầu/phút; hạn mức đầy đủ (8 và 300) sau lần nạp đầu |
| Khóa | mỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ |
| Nội dung | cho phép nội dung người lớn; từ chối nội dung tình dục liên quan đến trẻ vị thành niên |
| Đăng nhập | Google hoặc email và mật khẩu |
Mã lỗi
Lỗi trả về dạng JSON với type cố định; yêu cầu lỗi hoặc bị từ chối không bị tính phí.
| Mã | Loại | Ý nghĩa |
|---|---|---|
400 | bad_request | JSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh |
401 | missing_key · invalid_key · key_revoked | thiếu khóa, sai khóa hoặc khóa đã bị thay |
402 | no_credit | hết tín dụng — nạp tiền là dùng tiếp ngay |
403 | content_blocked | nội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí |
404 | not_found | endpoint không tồn tại |
413 | request_too_large | nội dung lớn hơn 8 MB |
429 | rate_limited · concurrency | vượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại |
503 | upstream_busy | mô hình đang bận — thử lại sau vài giây |
Hỏi đáp
API này có tương thích với SDK OpenAI chính thức không?
Có, nó tương thích hoàn toàn. Bạn chỉ cần thay đổi base URL và khóa API trong cấu hình SDK OpenAI hiện có để sử dụng dịch vụ này.
Điều gì xảy ra nếu tôi vượt quá giới hạn tốc độ?
API trả về lỗi 429 Too Many Requests. Bạn nên triển khai logic thử lại với backoff theo cấp số nhân để xử lý tình huống này một cách mượt mà.
Tôi có thể sử dụng API này cho tạo ảnh không?
Không, API này chỉ cung cấp hoàn thiện văn bản. Nó không hỗ trợ các endpoint tạo ảnh, âm thanh hoặc video.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ quá trình thiết lập.