Tài liệu API cho nhà phát triển

Base URL và Xác thực

Kết nối với cơ sở hạ tầng của chúng tôi bằng cách trỏ máy khách của bạn đến URL cơ sở được chỉ định và cung cấp khóa API độc nhất của bạn. Chúng tôi sử dụng xác thực tiêu đề tiêu chuẩn nên bạn có thể thay thế điểm cuối của chúng tôi vào các cấu hình SDK OpenAI hiện có mà không cần viết lại logic cốt lõi. Bạn nhận được một khóa hoạt động cho mỗi tài khoản và việc tạo khóa mới ngay lập tức sẽ vô hiệu hóa khóa trước đó. Thiết kế này giữ cho tích hợp của bạn đơn giản trong khi vẫn duy trì kiểm soát truy cập rõ ràng. Đăng ký qua Google hoặc email để xem khóa của bạn ngay lập tức. Chúng tôi không yêu cầu số điện thoại hoặc phương thức thanh toán để bắt đầu.

• Base URL: https://api.uncensoreai.com/v1
• Tiêu đề Auth: Authorization: Bearer YOUR_API_KEY

Yêu cầu đầu tiên (POST /v1/chat/completions)

Gửi lần hoàn tất đầu tiên bằng cách gửi một tải trọng JSON đến điểm cuối hoàn tất hội thoại. ID mô hình là uncensored và nó chấp nhận các cấu trúc tin nhắn tiêu chuẩn với các vai trò hệ thống, người dùng và trợ lý. Bạn nhận được đầu ra văn bản ngay lập tức mà không cần logic định tuyến phức tạp hoặc chọn mô hình. Lỗi không tiêu thụ khoản tín dụng trả trước của bạn, vì vậy bạn có thể kiểm tra tự do. Mô hình xử lý việc tạo nội dung trọng lượng mở được tinh chỉnh cho nội dung người lớn mà không từ chối. Sử dụng cấu trúc này để bắt đầu tích hợp của bạn.

Tích hợp SDK Python

Sử dụng client Python chính thức để tương tác với API của chúng tôi một cách liền mạch. Đặt base URL và API key trong đối tượng cấu hình của bạn trước khi thực hiện các lệnh gọi. Thư viện tự động xử lý serialization JSON và phân tích phản hồi cho bạn. Bạn có thể truy cập dữ liệu sử dụng trực tiếp từ đối tượng phản hồi. Cách tiếp cận này hoạt động với bất kỳ môi trường Python tiêu chuẩn nào hỗ trợ yêu cầu async hoặc sync. Giữ khóa của bạn an toàn trong các biến môi trường. Mẫu mã minh họa một lệnh gọi đồng bộ cơ bản.

Tích hợp SDK Node.js

Tích hợp với các dự án Node.js bằng trình quản lý gói tiêu chuẩn. Nhập client và cấu hình URL cơ sở trỏ đến máy chủ của chúng tôi. SDK quản lý các yêu cầu HTTP và cung cấp các phản hồi có kiểu cho người dùng TypeScript. Bạn có thể dễ dàng thêm tiêu đề hoặc sửa đổi thời gian chờ nếu cần. Phương pháp này phù hợp với các ứng dụng web hiện đại và dịch vụ backend. Đảm bảo phiên bản Node của bạn tương thích với các yêu cầu của SDK. Ví dụ sau đây cho thấy một yêu cầu hoàn thành đơn giản.

Phản hồi luồng và sử dụng token

Bật đầu ra thời gian thực bằng cách đặt stream flag thành true trong yêu cầu của bạn. API trả về Các sự kiện được máy chủ gửi (SSE) khi các token được tạo. Bạn có thể hiển thị văn bản cho người dùng ngay lập tức mà không cần chờ phản hồi đầy đủ. Chi tiết sử dụng token xuất hiện trong chunk cuối cùng của luồng. Tính năng này giảm độ trễ cảm nhận đối với các đầu ra dài. Hãy theo dõi số dư tín dụng của bạn khi các token tích lũy. Luồng hoạt động với tất cả các tham số tiêu chuẩn như nhiệt độ và các chuỗi dừng.

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

Tài khoản của bạn có cửa sổ ngữ cảnh 100.000 token cho cả đầu vào và đầu ra kết hợp. Bạn có thể gửi tối đa 16.000 token trong một phản hồi đơn lẻ nếu bạn chỉ định max_tokens. Giới hạn đầu ra mặc định là 2,048 token nếu bạn bỏ qua tham số này. Giới hạn tốc độ cho phép 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa. Mã trạng thái 401 có nghĩa là khóa của bạn không hợp lệ. Mã trạng thái 402 cho biết tín dụng trả trước không đủ. Mã trạng thái 429 có nghĩa là bạn đã vượt quá giới hạn tốc độ. Thân yêu cầu không được vượt quá 8 MB.

cURL

Copycurl https://api.uncensoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the current server status from the api endpoint"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)