Cài đặt và Thiết lập
Bắt đầu bằng cách tạo tài khoản để nhận khóa API của bạn. Đăng ký bằng tài khoản Google hoặc kết hợp email và mật khẩu. Hệ thống hiển thị khóa duy nhất của bạn ngay lập tức trên màn hình. Không yêu cầu xác minh số điện thoại cho bước này. Bạn có thể tạo khóa mới bất cứ lúc nào, nhưng mỗi tài khoản chỉ có một khóa hoạt động. Khóa mới sẽ thay thế khóa cũ ngay lập tức. Hãy giữ khóa này an toàn vì nó cấp quyền truy cập vào số dư trả trước của bạn. Sử dụng thông tin xác thực này với bất kỳ SDK tương thích OpenAI tiêu chuẩn nào để bắt đầu tích hợp.
Cấu hình Base
Điểm client của bạn đến URL gốc chuyên dụng cho các yêu cầu không kiểm duyệt. Sử dụng tiêu chuẩn BASE_URL tham số để định tuyến lưu lượng truy cập đúng cách. Cấu trúc điểm cuối mô phỏng theo các quy ước của OpenAI để dễ dàng chuyển đổi. Bạn phải cung cấp khóa API của mình trong Authorization header. Đặt ID mô hình thành uncensored trong đối tượng cấu hình của bạn. Điều này đảm bảo yêu cầu nhắm vào mô hình ngôn ngữ lớn không kiểm duyệt chính xác. Xác nhận kết nối của bạn bằng cách liệt kê các mô hình khả dụng thông qua /v1/models endpoint. Điều này xác nhận xác thực của bạn là hợp lệ trước khi gửi các tải trọng nặng.
Gửi yêu cầu
Thực hiện yêu cầu POST tiêu chuẩn đến điểm cuối hoàn thành trò chuyện. Tải trọng của bạn phải bao gồm model field được đặt thành uncensored. Truyền tin nhắn của bạn trong một mảng dưới messages khóa. Hệ thống chấp nhận các định nghĩa vai trò tiêu chuẩn như user và assistant. Token đầu vào được tính phí với tỷ lệ minh bạch là $0.15 cho mỗi triệu token. Token đầu ra tốn $0.50 cho mỗi triệu token. Lỗi không tiêu thụ số dư trả trước của bạn. Mô hình thanh toán này đảm bảo bạn chỉ trả tiền cho văn bản được tạo thực tế. Sử dụng lệnh cURL sau để gửi thông điệp đầu tiên của bạn.
Phản hồi luồng
Bật phát trực tiếp bằng cách đặt stream true trong yêu cầu của bạn. Máy chủ trả về một luồng các Sự kiện được gửi bởi máy chủ (SSE). Mỗi phần chứa một phần của văn bản được tạo. Phần cuối cùng bao gồm thống kê sử dụng token đầy đủ. Điều này cho phép bạn hiển thị văn bản cho người dùng theo thời gian thực. Phát trực tiếp hoạt động giống hệt nhau trên tất cả các SDK được hỗ trợ. Đảm bảo máy khách của bạn xử lý đúng các bộ đệm văn bản một phần. Sử dụng phương pháp này cho việc tạo nội dung dài hạn hoặc các giao diện trò chuyện tương tác. Ví dụ sau đây minh họa cách xử lý luồng trong Python.
Gọi hàm
Định nghĩa các công cụ trong yêu cầu của bạn bằng cách sử dụng tools tham số. Mô hình trả về các lệnh gọi công cụ có cấu trúc khi thích hợp. Bạn có thể chỉ định tool_choice để bắt buộc hành vi cụ thể. Truyền phản hồi công cụ trở lại mô hình để xử lý thêm. Điều này hỗ trợ các quy trình phức tạp yêu cầu tương tác API bên ngoài. Mô hình tự động xử lý định dạng JSON khi cần. Đảm bảo định nghĩa hàm của bạn khớp với lược đồ dự kiến. Tính năng này hoạt động cùng với cài đặt nhiệt độ và top-p tiêu chuẩn. Sử dụng Node.js để triển khai xử lý công cụ một cách hiệu quả.
Chế độ JSON và giới hạn
Yêu cầu đầu ra JSON nghiêm ngặt bằng cách đặt response_format để {"type": "json_object"}. Mô hình đảm bảo cấu trúc JSON hợp lệ trong phản hồi. Điều này rất lý tưởng để phân tích cú pháp dữ liệu trong logic ứng dụng của bạn. Hãy lưu ý giới hạn cửa sổ ngữ cảnh 100.000 token. Điều này bao gồm cả prompt và kết quả kết hợp. Lượng kết quả tối đa cho mỗi yêu cầu là 16.000 token. Nếu bạn không chỉ định max_tokens, giới hạn mặc định là 2.048. Các yêu cầu được giới hạn ở 300 mỗi phút mỗi khóa. Các yêu cầu đồng thời được giới hạn ở tám yêu cầu đồng thời. Thân yêu cầu không được vượt quá 8 MB. Xử lý lỗi một cách duyên dáng như được hiển thị trong ví dụ stream sau.
cURL
curl https://api.modelsuncensoredopenrouter.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "list three json keys"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.modelsuncensoredopenrouter.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.modelsuncensoredopenrouter.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);Phát trực tiếp
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)