Cách sử dụng API tương thích OpenAI trong 5 bước
Sử dụng API kiểu OpenAI gồm năm bước: lấy khóa, cài SDK, trỏ nó vào base URL đúng, đặt tên mô hình và gửi tin nhắn. Dưới đây là từng bước kèm mã bạn có thể dán.

Điểm chính
- Bất kỳ SDK OpenAI nào cũng hoạt động ở đây sau khi bạn thay đổi base URL thành https://api.uncensoredaiapis.com/v1 và sử dụng khóa của riêng bạn.
- ID mô hình là uncensored; các endpoint chính là POST /v1/chat/completions và GET /v1/models.
- Streaming, chế độ JSON và gọi hàm sử dụng cùng tham số như API chính thức.
- Giá là $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra, và bạn có thể bắt đầu với $0.50 tín dụng dùng thử.
Tóm tắt nhanh
Nếu bạn muốn biết cách sử dụng các lệnh gọi API OpenAI với một dịch vụ không phải OpenAI, câu trả lời là định dạng yêu cầu là một quy ước chung. Client nói ngôn ngữ đó cần ba giá trị: nơi gửi yêu cầu (base URL), bạn là ai (khóa) và mô hình nào để chạy. Thay đổi ba giá trị này và cùng mã nguồn sẽ hoạt động. Trang web này tuân theo quy ước đó, nên các gói Python và Node.js chuẩn của OpenAI, cũng như curl thuần, đều hoạt động với nó.
Hãy rõ ràng về những gì điều đó có và không có nghĩa. Tương thích có nghĩa là giao diện khớp với nhau. Nó không có nghĩa đây là dịch vụ chính thức của OpenAI hay chạy các mô hình của OpenAI. Backend là một mô hình trọng số mở, do nhà cung cấp độc lập chạy và được tinh chỉnh để trả lời mà không từ chối nội dung cho việc sử dụng hợp pháp của người lớn, và bạn chọn nó bằng model ID uncensored. Nó chỉ xử lý văn bản: không có hình ảnh, âm thanh, embedding hay fine-tuning.
Năm bước dưới đây mất khoảng mười phút. Nếu bạn thích đọc các đoạn mã hoàn chỉnh bằng nhiều ngôn ngữ, hãy xem trang ví dụ mã.
Bước 1: lấy khóa
Đăng ký bằng Google, hoặc bằng email và mật khẩu, và mở trang khóa API. Người dùng mới có thể nhận $0.50 tín dụng dùng thử chỉ với một cú nhấp chuột. Nó có hiệu lực trong 7 ngày, giới hạn một lần cho mỗi người và không cần thẻ. Sao chép khóa và lưu nó dưới dạng biến môi trường thay vì dán nó vào mã:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"Khóa dùng thử bị giới hạn ở 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Khóa trả trước cho phép 8 yêu cầu đồng thời và 300 mỗi phút. Chi tiết về những gì gói dùng thử bao gồm có trong FAQ dùng thử miễn phí.
Bước 2: cài SDK và gửi yêu cầu đầu tiên
Cài gói chính thức cho ngôn ngữ của bạn. Cả hai thư viện này đều là những thư viện bạn sẽ dùng cho bất kỳ dịch vụ kiểu OpenAI nào:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiBây giờ là một lệnh gọi đầu tiên bằng Python. Sự khác biệt duy nhất so với cài đặt mặc định là đối số base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)Và cùng một lệnh gọi trong Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Bước 3: hiểu mảng messages
Các mô hình chat không nhớ gì giữa các lần gọi. Mỗi yêu cầu mang toàn bộ cuộc trò chuyện dưới dạng danh sách các tin nhắn, và mỗi tin nhắn có một vai trò.
systemthiết lập hành vi và phong cách. Đặt persona, quy tắc định dạng và các ràng buộc ở đây.userchứa những gì người dùng đã hỏi.assistantchứa các phản hồi trước đó của mô hình. Bạn tự thêm những nội dung này khi tiếp tục cuộc trò chuyện.toolmang kết quả của một lệnh gọi hàm, được đề cập bên dưới.
Để tiếp tục cuộc trò chuyện, hãy thêm phản hồi của assistant và tin nhắn user tiếp theo vào cùng danh sách và gửi lại toàn bộ. Đây là lý do tại sao các cuộc hội thoại dài tốn nhiều tiền hơn: mỗi lệnh gọi trả tiền cho toàn bộ lịch sử dưới dạng token đầu vào. Cửa sổ ngữ cảnh chứa tổng cộng 100.000 token, bao gồm prompt và completion, nên việc cắt bớt các lượt cũ là một phần bình thường khi xây dựng ứng dụng chat.
Các trường lấy mẫu hữu ích được chuyển tiếp: temperature, top_p, stop, seed và các hình phạt về tần suất và sự hiện diện. max_tokens là tùy chọn. Đặt nó khi bạn muốn giới hạn độ dài phản hồi và chi tiêu.
Bước 4: streaming, chế độ JSON và tools
Truyền phát
Thêm stream: true để nhận token dưới dạng sự kiện do máy chủ gửi. Nó làm cho giao diện cảm thấy nhanh hơn, vì văn bản xuất hiện trong khi mô hình vẫn đang viết, và việc sử dụng được báo cáo vào cuối luồng.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Chế độ JSON
Sử dụng response_format: {"type": "json_object"} khi mã của bạn phân tích cú pháp phản hồi. Mô tả các khóa mong muốn trong prompt.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Gọi hàm
Gửi danh sách tools với lược đồ hàm, và tùy chọn tool_choice. Khi mô hình muốn chạy một hàm, phản hồi chứa tool_calls. Bạn chạy hàm trong mã của riêng mình và gửi kết quả lại dưới dạng tin nhắn với vai trò tool. Các lệnh gọi công cụ cũng được streaming. Đây là khối xây dựng cho các agent; trang trường hợp sử dụng cho thấy nơi điều đó phát huy hiệu quả.
Bước 5: biết các giới hạn, chi phí và lỗi
Vượt quá giới hạn, API trả về HTTP 429. Mã lỗi là rate_limited cho quá nhiều yêu cầu mỗi phút và concurrency cho quá nhiều cùng lúc. Quá tải tạm thời cũng trả về 429, với tiêu đề Retry-After: 5. Một yêu cầu streaming giữ slot độ đồng thời của nó cho đến khi luồng kết thúc, vì vậy hãy đóng các luồng bạn không còn đọc. Giới hạn body yêu cầu là 8 MB. Mọi phản hồi đều mang tiêu đề X-Request-Id và X-Balance-USD, và tiêu đề đầu tiên là thứ bạn trích dẫn để hỗ trợ.
Chi phí rất đơn giản. Một lệnh gọi chat với 3.000 token đầu vào và 700 token đầu ra tốn 3.000 nhân $0.15 cho mỗi triệu, tức là $0.00045, cộng 700 nhân $0.50 cho mỗi triệu, tức là $0.00035, tổng cộng $0.0008. Một nghìn lệnh gọi như vậy tốn $0.80. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí, và tín dụng không bao giờ hết hạn. Trang giá cả liệt kê các khoản nạp tiền từ $20 đến $500 với +5% từ $50, +10% từ $100 và +15% từ $200. Bạn có thể thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base).
Cách nó khác với API chính thức
Ba điểm khác biệt đáng để bạn lên kế hoạch. Thứ nhất, tên mô hình: hãy dùng uncensored, không phải tên mô hình của OpenAI. Thứ hai, phạm vi: bạn chỉ nhận được chat completions và danh sách mô hình, vì vậy các tính năng như tạo ảnh, speech, embeddings và fine-tuning không có ở đây. Thứ ba, hành vi: mô hình được tinh chỉnh để không từ chối các yêu cầu hợp pháp của người lớn, vì vậy đầu ra có thể khác với một trợ lý bị lọc kỹ. Một quy tắc không bao giờ thay đổi: không có nội dung tình dục liên quan đến người chưa thành niên.
Một vài thói quen giúp ích ngay từ ngày đầu. Giữ khóa trong biến môi trường, ghi lại X-Request-Id của mọi lệnh gọi, và đặt max_tokens trong khi bạn thử nghiệm để một phản hồi chạy không thể tiêu tốn nhiều hơn bạn dự định. Khi bạn xây dựng giao diện chat, hãy streaming phản hồi và cắt bớt các lượt cũ khi lịch sử phát triển. Khi bạn xây dựng pipeline phân tích đầu ra, hãy sử dụng chế độ JSON và vẫn bảo vệ việc phân tích cú pháp, vì một phản hồi bị cắt ở giới hạn token không phải là JSON hợp lệ. Và khi hai phần trong chương trình của bạn gọi API cùng lúc, hãy tính chúng vào 8 yêu cầu đồng thời mà khóa đầy đủ cho phép.
Đừng quên chi phí kiểm thử. Vài chục thí nghiệm với các prompt ngắn tốn ít hơn một xu tổng cộng, vì vậy $0.50 tín dụng dùng thử đi được rất xa trong khi bạn học định dạng yêu cầu.
Nếu bạn đang di chuyển một ứng dụng hiện có, hướng dẫn di chuyển sẽ đi qua các thay đổi theo thứ tự. Các prompt gửi ở đây không được dùng để huấn luyện. Đối với hầu hết các ứng dụng, quá trình di chuyển là ba giá trị từ đầu trang này và tên mô hình.
Hướng dẫn khác
Hỏi đáp
Bạn có cần SDK chính thức của OpenAI không?
Bạn có thể dùng nó, và đây là cách dễ nhất. Bất kỳ client tương thích OpenAI hoặc HTTP thuần cũng hoạt động, miễn là hỗ trợ base URL tùy chỉnh.
Tôi gửi tên mô hình nào?
Gửi uncensored. Base URL là https://api.uncensoredaiapis.com/v1.
Đây có phải là API OpenAI chính thức không?
Không. Nó tuân theo cùng định dạng yêu cầu, nhưng mô hình là mô hình trọng số mở do nhà cung cấp độc lập vận hành, và dịch vụ này tách biệt với OpenAI.
Một yêu cầu tốn bao nhiêu?
Token đầu vào tốn $0.15 cho mỗi 1M và token đầu ra $0.50 cho mỗi 1M. Một yêu cầu với 3.000 token đầu vào và 700 token đầu ra tốn khoảng $0.0008.
Tôi có thể dùng thử trước khi trả tiền không?
Có. Sau khi đăng ký, bạn có thể nhận $0.50 tín dụng dùng thử chỉ với một cú nhấp chuột. Nó có hiệu lực trong 7 ngày và không cần thẻ.
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 URL cơ sở. Đó là toàn bộ thiết lập.