Hướng dẫn bắt đầu nhanh API không kiểm duyệt
Bắt đầu ngay với API không kiểm duyệt: Nhận khóa API và bắt đầu tạo văn bản chỉ với vài dòng mã nhờ hạ tầng tương thích OpenAI của chúng tôi. Hướng dẫn thiết lập nhanh cho việc tạo văn bản thuần túy, cửa sổ ngữ cảnh lớn và truy cập trực tiếp.
- Base URL
- https://api.sansursuzapi.com/v1
- Mô hình
- không kiểm duyệt
Cài đặt và Thư viện cần thiết
API không kiểm duyệt, được thiết kế để hoạt động tương thích trực tiếp với các SDK và client của OpenAI. Để thiết lập tích hợp, bạn chỉ cần đặt giá trị base_url trong mã hiện tại của bạn thành https://api.sansursuzapi.com/v1 và cấu hình khóa API của bạn. Bạn chỉ cần cài đặt gói SDK phù hợp cho ngôn ngữ bạn đang sử dụng; không cần cấu hình máy chủ bổ sung hay cơ chế xác thực phức tạp. Hệ thống của chúng tôi sử dụng xác thực token Bearer tiêu chuẩn và chúng tôi chuyển khóa API của bạn trực tiếp trong các tiêu đề yêu cầu.
Ví dụ yêu cầu cơ bản
Bạn có thể kích hoạt tạo văn bản bằng cách gửi một yêu cầu POST đơn giản để bắt đầu sử dụng API. Ví dụ dưới đây cho thấy cách truy cập vào mô hình uncensored thông qua curl. Thân yêu cầu bao gồm tên mô hình, tin nhắn của người dùng và định dạng phản hồi. Cấu trúc này tuân theo lược đồ chat-completions tiêu chuẩn của OpenAI.
curl https://api.sansursuzapi.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."}]
}'
Yêu cầu này là điểm bắt đầu lý tưởng để kiểm tra hành vi không kiểm duyệt của mô hình. Đối tượng JSON trả về chứa văn bản được tạo và thống kê token. Bạn có thể sử dụng cấu trúc đơn giản này cho các kiểm tra nhanh, sau đó tùy chỉnh các tham số theo nhu cầu của dự án.
Truyền phát và Gọi hàm
Đối với các khối văn bản lớn hoặc kịch bản lịch sử hội thoại dài, bạn có thể sử dụng chế độ truyền phát (streaming). Chế độ này cho phép bạn xử lý dữ liệu từ máy chủ từng phần một, cải thiện trải nghiệm người dùng. Ngoài ra, tính năng gọi hàm (function calling) cũng được hỗ trợ, cho phép mô hình tương tác với các công cụ bên ngoài. Tính năng này cho phép mô hình trả về dữ liệu theo một lược đồ JSON cụ thể và xử lý dữ liệu đó trong ứng dụng của bạn.
from openai import OpenAI
client = OpenAI(base_url="https://api.sansursuzapi.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)
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.sansursuzapi.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);
SDK Python và Node.js cung cấp các công cụ cần thiết để quản lý các cấu trúc truyền phát và hàm này. Bạn có thể nhận phản hồi từng phần bằng tham số stream: true hoặc cấu hình việc tạo dữ liệu của mô hình bằng cách sử dụng cấu trúc tools.
Danh sách mô hình và Tương thích
API của chúng tôi hiện cung cấp một mô hình ngôn ngữ lớn duy nhất: uncensored. Mô hình này có cấu trúc trọng số mở được tinh chỉnh đặc biệt và được tối ưu hóa để loại bỏ các bộ lọc nhân tạo thường thấy ở các mô hình tiêu chuẩn. Bạn có thể xác minh mô hình hiện có thông qua endpoint danh sách mô hình (GET /v1/models). Mô hình hoạt động trên máy chủ GPU của chúng tôi, độc lập với các chuỗi GPT, Claude, Gemini hoặc Grok của OpenAI. Sự tương thích này cho phép bạn sử dụng trực tiếp các máy khách OpenAI hiện có.
Mã lỗi và Giới hạn
Các mã trạng thái chính bạn có thể gặp phải khi sử dụng API bao gồm: 401 khóa API không hợp lệ hoặc thiếu, 402 không đủ tín dụng và 429 vượt quá giới hạn 300 yêu cầu mỗi phút. Mỗi tài khoản chỉ có một khóa API hợp lệ; khi khóa được làm mới, khóa cũ sẽ bị vô hiệu hóa. Thân yêu cầu không được vượt quá 8 MB. Cửa sổ ngữ cảnh (context window) được giới hạn ở 100.000 token; điều này đề cập đến tổng số token cho cả prompt và văn bản hoàn thành. Các giới hạn này rất quan trọng để API hoạt động ổn định.
Bảng giá và Quản lý tín dụng
API không kiểm duyệt hoạt động theo mô hình trả tiền theo mức sử dụng (pay-as-you-go). Bạn sẽ bị tính phí 0,25 $ cho mỗi 1 triệu token đầu vào và 1,00 $ cho mỗi 1 triệu token đầu ra. Tín dụng đã trả tiền được lưu trữ vô thời hạn và không có phí đăng ký. Các tài khoản mới nhận được tín dụng dùng thử trị giá 0,50 $ có hiệu lực trong 7 ngày mà không cần thẻ tín dụng. Khi hết tín dụng, dịch vụ không bị ngắt, bạn chỉ cần nạp thêm tín dụng cho các yêu cầu mới. Bonus +5% áp dụng khi nạp 50 $ và bonus +10% áp dụng khi nạp 100 $.
Truyền phát
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 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID mô hình | uncensored |
| Base URL | https://api.sansursuzapi.com/v1 |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Đầ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) |
| 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 |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Kích thước yêu cầu | tối đa 8 MB |
| Giá | $0,25 cho 1 triệu token đầu vào · $1,00 cho 1 triệu token đầu ra |
| Thưởng | +5% từ $50, +10% từ $100 |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $10 đến $500 |
| 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í |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| 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 |
Câu hỏi thường gặp
Tôi quản lý khóa API như thế nào và sẽ xảy ra gì nếu tôi làm mất nó?
Bạn có thể xem hoặc làm mới khóa API từ bảng điều khiển tài khoản của mình. Khi khóa được làm mới, khóa cũ sẽ lập tức hết hiệu lực và không thể sử dụng cho các yêu cầu mới. Mỗi tài khoản chỉ có một khóa hoạt động.
Tín dụng tôi sử dụng có bị hết hạn không?
Không, tín dụng bạn đã trả tiền không bao giờ hết hạn. Khi hết tín dụng, dịch vụ không bị ngắt hoàn toàn, nhưng bạn cần nạp thêm tín dụng để tạo token mới. Số dư tín dụng của bạn được lưu trữ vĩnh viễn trên tài khoản.
Mô hình từ chối những loại nội dung nào?
Mô hình thường không từ chối nội dung người lớn hợp pháp, kịch bản hư cấu và nghiên cứu bảo mật. Tuy nhiên, có một giới hạn nghiêm ngặt luôn được áp dụng: nội dung khiêu dâm liên quan đến vị thành niên/trẻ em luôn bị chặn. Giới hạn này được áp dụng ở cấp hệ thống, độc lập với các cài đặt của mô hình.
Khoảng cách đến khóa của bạn chỉ bằng một biểu mẫu
Tạo tài khoản, sao chép khóa và thay đổi base URL. Việc thiết lập đơn giản như vậy đó.