Tài liệu API không kiểm duyệt

Xác thực và Base URL

Khóa API của bạn xác thực mọi yêu cầu. Sử dụng URL cơ sở HTTPS://api.uncensores.cc/v1 với bất kỳ SDK OpenAI tiêu chuẩn nào. Định danh mô hình là "uncensored". Truyền khóa của bạn trong tiêu đề Authorization dưới dạng token Bearer. Bạn có thể tạo khóa qua bảng điều khiển bằng Google hoặc email. Mỗi tài khoản chỉ giữ một khóa hoạt động, khóa này sẽ thay thế khóa trước đó.

Copycurl https://api.uncensores.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top ten python libraries for data science"}]
  }'

Bạn phải bao gồm trường model trong mọi yêu cầu. Điểm cuối mong đợi một mảng messages chứa lịch sử hội thoại của bạn. Nếu khóa bị thiếu hoặc không hợp lệ, API sẽ trả về lỗi 401. Điều này đảm bảo chỉ những người dùng được ủy quyền mới tiêu thụ khoản tín dụng trả trước của bạn.

Điểm cuối Chat Completions

Gửi các yêu cầu POST đến /v1/chat/completions để tạo văn bản. Điểm cuối này xử lý các lời nhắc hội thoại tiêu chuẩn và trả về các phản hồi văn bản có cấu trúc. Nó không hỗ trợ embedding hoặc tạo hình ảnh. Bạn cung cấp các thông điệp hệ thống, người dùng và trợ lý để hướng dẫn mô hình. Mô hình phản hồi bằng nội dung văn bản thô bên trong mảng choices.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensores.cc/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)

Khởi tạo client với URL cơ sở và khóa. Xác định danh sách tin nhắn với vai trò và nội dung mong muốn của bạn. Thực thi phương thức chat.completions.create. Đối tượng phản hồi chứa văn bản được tạo và thống kê sử dụng. Cách tiếp cận trực tiếp này loại bỏ độ phức tạp của việc định tuyến cho các nhiệm vụ viết NSFW hoặc sáng tạo.

Phản hồi luồng với SSE

Bật phát trực tiếp bằng cách đặt stream thành true trong yêu cầu. API trả về Sự kiện được gửi bởi máy chủ (SSE) khi các token có sẵn. Điều này giảm độ trễ cảm nhận đối với các đầu ra dài. Mỗi chunk chứa một phần delta của phản hồi. Bạn phải tích lũy các phần delta này để tái tạo lại văn bản cuối cùng.

Copystream = 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)

Chunk cuối cùng bao gồm thống kê sử dụng đầy đủ cho yêu cầu. Điều này cho phép bạn theo dõi mức tiêu thụ token theo thời gian thực. Streaming lý tưởng cho các giao diện trò chuyện nơi người dùng mong đợi phản hồi ngay lập tức. Nó hoạt động liền mạch với định dạng đầu ra của mô hình uncensored.

Function Calling và chế độ JSON

API hỗ trợ gọi hàm thông qua tham số tools. Định nghĩa lược đồ hàm của bạn trong yêu cầu và đặt tool_choice là auto hoặc một tên cụ thể. Mô hình sẽ trả về các lệnh gọi hàm trong phản hồi thay vì văn bản thuần túy. Bạn cũng có thể buộc đầu ra ở định dạng JSON bằng cách đặt response_format là json_object. Điều này đảm bảo việc phân tích cú pháp dự đoán được cho các quy trình tự động hóa.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensores.cc/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);

Định nghĩa các định nghĩa công cụ trong mảng tools. Mô hình sẽ chọn hàm phù hợp dựa trên đầu vào. Bạn nhận được tên hàm và đối số trong phản hồi. Tính năng này hoạt động cùng với các hoàn thành trò chuyện tiêu chuẩn mà không cần điểm cuối bổ sung. Sử dụng nó để trích xuất dữ liệu có cấu trúc hoặc hành vi giống tác nhân.

Tham số: Nhiệt độ, Top-P và Seeds

Điều chỉnh nhiệt độ để kiểm soát tính ngẫu nhiên. Giá trị trên 1 tăng cường tính sáng tạo, trong khi giá trị dưới 1 làm cho đầu ra mang tính xác định hơn. Sử dụng top_p để giới hạn việc lấy mẫu vào phần trăm khối lượng xác suất cao nhất. Đặt seed để có kết quả có thể tái lập qua các yêu cầu giống hệt nhau. Các tham số này cho phép tinh chỉnh phong cách đầu ra của mô hình không kiểm duyệt.

Bạn cũng có thể sử dụng các chuỗi dừng (stop sequences) để dừng quá trình tạo tại các chuỗi cụ thể. presence_penalty và frequency_penalty giúp giảm sự lặp lại. Nhiệt độ mặc định là 1.0. Điều chỉnh các cài đặt này giúp tối ưu hóa cho việc đóng vai hoặc viết kỹ thuật. Mỗi yêu cầu hỗ trợ các tham số tương thích tiêu chuẩn với OpenAI.

Giới hạn Token và Cửa sổ ngữ cảnh

Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token cho cả prompt và completion. Bạn có thể xuất tối đa 16.000 token mỗi yêu cầu. Nếu bạn bỏ qua max_tokens, mặc định là 2.048 token. Giới hạn này áp dụng cho tổng đầu vào và đầu ra. Các yêu cầu vượt quá kích thước thân yêu cầu 8 MB sẽ thất bại. API áp dụng giới hạn tốc độ 300 yêu cầu mỗi phút. Các yêu cầu đồng thời được giới hạn ở 8 mỗi key. Các lỗi như 402 (không có credit) hoặc 429 (giới hạn tốc độ) cung cấp phản hồi rõ ràng. Số dư chưa sử dụng không bao giờ hết hạn, đảm bảo bạn chỉ trả tiền cho việc sử dụng thực tế.