Các endpoint API tương thích OpenAI: Những tính năng được hỗ trợ
Danh sách các endpoint API tương thích OpenAI mà dịch vụ này hỗ trợ, kèm theo các yêu cầu hoạt động cho từng endpoint và danh sách rõ ràng những tính năng bị thiếu.
Điểm chính
- Năm đường dẫn: chat completions, responses, models và hai điểm cuối balance.
- ID mô hình là uncensored, và một khóa API hoạt động với bất kỳ SDK OpenAI nào.
- Không có ảnh, âm thanh, video, embeddings hoặc fine-tuning.
- Giới hạn trả về HTTP 429 kèm mã lỗi rõ ràng.

Tổng quan về các endpoint
Các đường dẫn kiểu OpenAI nào nhà cung cấp thực sự triển khai? Đây là danh sách ngắn cho API này. Base URL: https://api.uncensoredendpoint.com/v1. Xác thực là khóa Bearer trên mọi lượt gọi.
| Phương thức và đường dẫn | Mục đích |
|---|---|
POST /v1/chat/completions | Yêu cầu chat, streaming, công cụ, chế độ JSON |
POST /v1/responses | Định dạng yêu cầu kiểu Responses mới hơn |
GET /v1/models | Liệt kê mô hình; ID là uncensored |
GET /v1/dashboard/billing/credit_grants | Balance theo định dạng kiểu OpenAI |
GET /v1/balance | Balance ở dạng đơn giản |
Đó là toàn bộ phạm vi. Mọi thứ không có trong bảng không được cung cấp. Hãy tiếp tục đọc để biết các yêu cầu hoạt động và danh sách những gì còn thiếu, để bạn có thể lên kế hoạch trước khi viết mã.
Hoàn thành chat
Đây là endpoint mà hầu hết các client sử dụng. Hãy trỏ bất kỳ SDK OpenAI nào vào base URL và dùng tên mô hình uncensored.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "List three uses of a webhook."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)Các tham số được hỗ trợ bao gồm stream, tools, tool_choice, response_format với json_object, và bộ lấy mẫu: temperature, top_p, stop, seed và các hệ số phạt. max_tokens là tùy chọn, vì một completion có thể sử dụng bất kỳ phần nào còn lại của cửa sổ 100.000 token.
Với stream: true, phản hồi đến dưới dạng server-sent events và dữ liệu sử dụng được bao gồm ở cuối, để bạn vẫn có thể ghi lại số lượng token.
Chat đa lượt
API không giữ trạng thái hội thoại. Để chat đa lượt, bạn gửi danh sách tin nhắn đầy đủ mỗi lần: tin nhắn hệ thống trước, sau đó là các lượt user và assistant xen kẽ. Điều này có nghĩa là input tokens tăng lên sau mỗi lượt, và chi phí cũng tăng theo, nên hãy cắt giảm hoặc tóm tắt các lượt cũ khi cuộc hội thoại dài. Cửa sổ là 100.000 token cho prompt cộng với completion, đủ cho hầu hết các cuộc chat nhưng dễ bị lấp đầy bằng tài liệu dán vào.
Phản hồi, mô hình và số dư
Phản hồi
Các ví dụ OpenAI mới hơn dùng /v1/responses. Nó cũng có ở đây, nên mã viết cho định dạng đó không cần thay đổi.
curl https://api.uncensoredendpoint.com/v1/responses \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "input": "Write a haiku about caching."}'Hãy dùng cái mà client của bạn mong đợi. Nếu bạn bắt đầu từ đầu, chat completions có hỗ trợ công cụ rộng nhất.
Mô hình và số dư
Liệt kê các mô hình để kiểm tra xem khóa của bạn có hoạt động không. Bạn sẽ thấy một mục duy nhất, uncensored, vì dịch vụ chạy một mô hình và không phải là router giữa các nhà cung cấp.
curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"
# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"
# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"Bạn cũng nhận được số dư trên mọi phản hồi trong tiêu đề X-Balance-USD, rất hữu ích để cảnh báo khi tín dụng thấp trong ứng dụng của bạn mà không cần thêm một yêu cầu nào. Các tiêu đề khác bao gồm X-Request-Id cho các câu hỏi hỗ trợ, cùng với X-RateLimit-Limit-Requests và X-RateLimit-Limit-Concurrency.
Công cụ và chế độ JSON trong thực tế
Hai tính năng biến một endpoint chat thành thứ bạn có thể xây dựng sản phẩm dựa trên đó. Gọi công cụ cho phép mô hình yêu cầu mã của bạn chạy một hàm. Chế độ JSON khiến nó trả về đầu ra có thể phân tích được. Cả hai đều sử dụng các trường yêu cầu tiêu chuẩn.
Một lệnh gọi công cụ trông như thế này. Mô hình trả về một mục tool_calls, bạn chạy hàm, và gửi lại kết quả dưới dạng tin nhắn với role: "tool".
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)
msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)Đối với chế độ JSON, thêm response_format={"type": "json_object"} và nói trong prompt rằng bạn muốn JSON, lý tưởng nhất là với các khóa bạn mong đợi. Luôn phân tích dữ liệu trong một khối try: không có mô hình nào đảm bảo schema của bạn trên mọi lệnh gọi, nên hãy xác thực kết quả trước khi tin tưởng nó.
Di chuyển dự án OpenAI hiện có
Nếu ứng dụng của bạn đã dùng SDK OpenAI, việc di chuyển chỉ cần ba lần chỉnh sửa và không cần thư viện mới. Hầu hết các SDK đọc cùng hai biến môi trường, nên bạn thường có thể không thay đổi gì trong mã.
export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEYimport OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);Sau đó, hãy tìm kiếm trong mã của bạn các tên mô hình như ID mô hình GPT và thay thế chúng bằng uncensored, vì dịch vụ chỉ có một mô hình. Loại bỏ các lệnh gọi embeddings, ảnh hoặc âm thanh, và chuyển hướng những lệnh gọi đó sang nhà cung cấp khác. Hãy giữ một danh sách kiểm tra ngắn gọn: URL cơ bản đã thay đổi, tên mô hình đã thay đổi, khóa được lưu trong biến môi trường chứ không phải trong kho lưu trữ, logic thử lại cho lỗi 429 và cảnh báo hết số dư dựa trên tiêu đề số dư. Để thiết lập khóa, xem cách lấy khóa API AI uncensored. Sau đó, hãy chạy một yêu cầu thử nghiệm đơn lẻ và kiểm tra xem X-Balance-USD có trả về hay không, trước khi chuyển lưu lượng thực.
Những tính năng không có
Việc biết các điểm thiếu giúp bạn tiết kiệm một ngày gỡ lỗi. API này chỉ dành cho văn bản. Các endpoint OpenAI sau không có sẵn:
- Ảnh và tạo hình ảnh. Không có tạo hoặc chỉnh sửa ảnh.
- Âm thanh. Không có chuyển đổi giọng nói sang văn bản hoặc văn bản sang giọng nói.
- Video. Không được hỗ trợ.
- Embeddings. Nếu bạn xây dựng truy xuất, bạn cần một dịch vụ embedding riêng biệt.
- Fine-tuning. Bạn không thể huấn luyện trên dịch vụ này.
Các lệnh gọi đến những đường dẫn đó sẽ thất bại, nên hãy loại chúng khỏi bất kỳ cấu hình client chia sẻ nào. Một thiết lập điển hình kết hợp API này cho chat với nhà cung cấp khác cho embeddings, và ứng dụng của bạn chọn base URL theo nhiệm vụ.
Giới hạn, lỗi và thử lại
Một khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Một khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Phần thân yêu cầu tối đa là 8 MB. Khi bạn vượt quá giới hạn, bạn sẽ nhận được HTTP 429 với mã lỗi cho biết giới hạn nào: rate_limited cho yêu cầu mỗi phút, concurrency cho quá nhiều yêu cầu cùng lúc. Khi quá tải tạm thời, bạn cũng nhận được 429, với tiêu đề Retry-After: 5.
Một chi tiết khiến nhiều người bất ngờ: một yêu cầu streaming giữ slot concurrency của nó cho đến khi stream kết thúc, vì vậy những người đọc chậm sẽ tính vào giới hạn. Một trình bao bọc thử lại đơn giản xử lý tất cả điều này:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
def ask(prompt, tries=4):
for i in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (i + 1))
raise RuntimeError("still rate limited")Các yêu cầu bị lỗi hoặc bị từ chối không bị tính phí, vì vậy các lần thử lại khi gặp lỗi không tốn thêm chi phí. Đối với các tác vụ batch, hãy giới hạn nhóm worker của bạn ở mức 8 đối với khóa đầy đủ, hoặc 2 đối với khóa dùng thử, thay vì dựa vào các lần thử lại. Một nhóm cố định dễ suy luận hơn và nó giữ cho một stream chậm không làm nghẽn các stream khác.
Chi phí và truy cập
Giá là $0,15 cho mỗi 1M input tokens và $0,50 cho mỗi 1M output tokens, từ tín dụng trả trước không đăng ký và không hết hạn. Nạp tiền với bất kỳ số nguyên nào từ $20 đến $500, bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Các khoản nạp lớn hơn thêm bonus: +5% từ $50, +10% từ $100, +15% từ $200. Xem trang giá cả.
Để thử, hãy đăng ký bằng Google hoặc email, sau đó nhận tín dụng dùng thử $0,50 với một cú nhấp chuột trên trang khóa API. tài liệu bao gồm từng tham số, và tổng quan endpoint giải thích dịch vụ là gì: một mô hình trọng số mở cho việc sử dụng người lớn hợp pháp, không từ chối nội dung và cấm nghiêm ngặt nội dung tình dục liên quan đến người chưa thành niên.
Hướng dẫn khác
Hỏi đáp
Nó có hỗ trợ truyền phát (streaming) và gọi hàm không?
Có. Bạn dùng stream: true cho server-sent events với usage ở cuối, và tools với tool_choice cho gọi hàm.
Có endpoint embeddings không?
Không. Dịch vụ chỉ hỗ trợ trò chuyện văn bản, vì vậy bạn hãy sử dụng nhà cung cấp khác cho embedding.
Bạn kiểm tra số dư của mình như thế nào?
Gọi GET /v1/balance hoặc đường dẫn credit_grants kiểu OpenAI, hoặc đọc tiêu đề X-Balance-USD trên bất kỳ phản hồi nào.
Điều gì xảy ra khi tôi đạt giới hạn tốc độ?
Bạn nhận được HTTP 429 với mã rate_limited hoặc concurrency. Bạn hãy đợi và thử lại; khi quá tải tạm thời, header Retry-After cho biết 5 giây.
Khóa của bạn chỉ cách một bước điền thông tin
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.