Tài liệu API & Bắt đầu nhanh

Xác thực & Base URL

Bắt đầu mọi yêu cầu bằng cách trỏ máy khách của bạn vào HTTPS://api.uncensoredia.com/v1 và đính kèm khóa của bạn. Authorization uses the standard Bearer scheme, vì vậy bạn chỉ cần dán token bạn nhận được sau khi đăng ký bằng Google hoặc email. Điểm cuối hoàn toàn API tương thích OpenAI tuân thủ, nghĩa là bạn chỉ cần thay đổi URL cơ sở và khóa API trong cấu hình hiện có của mình. Bạn không cần quản lý các lớp định tuyến phức tạp hoặc tiêu đề proxy. Chỉ cần đảm bảo Authorization header chứa token duy nhất của bạn. Cấu hình này đảm bảo rằng các yêu cầu của bạn đến được mô hình không kiểm duyệt chuyên dụng mà không có bất kỳ bộ lọc trung gian nào. Nếu bạn nhận được 401 lỗi, hãy xác minh rằng khóa của bạn còn hoạt động và được định dạng chính xác.

Endpoint Hoàn thành Trò chuyện

Gửi tin nhắn đến POST /v1/chat/completions để nhận phản hồi dạng văn bản từ mô hình không kiểm duyệt. Endpoint đơn lẻ này xử lý mọi nhu cầu tạo nội dung của bạn, từ các prompt đơn giản đến các cuộc hội thoại đa lượt phức tạp. Bạn có thể kiểm soát độ dài và tính ngẫu nhiên của đầu ra bằng các tham số như max_tokens, temperature, và top_p. Mô hình hỗ trợ một cửa sổ 100.000 token cửa sổ ngữ cảnh, cho phép bạn cung cấp tài liệu mở rộng hoặc lịch sử hội thoại dài. Bạn có thể gửi tối đa 16,000 token trong phản hồi. Nếu bạn bỏ qua max_tokens, giới hạn mặc định là 2.048 token. Endpoint này không hỗ trợ tạo hình ảnh hoặc âm thanh. Nó chỉ hỗ trợ văn bản vào, văn bản ra. Sử dụng lệnh curl sau để kiểm tra kết nối của bạn ngay lập tức.

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI để tương tác với API với ít thay đổi mã nhất. Bạn chỉ cần ghi đè base_url và api_key trong cấu hình máy khách. Cách tiếp cận này đảm bảo rằng logic hiện có của bạn để xử lý phản hồi, lỗi và thử lại vẫn được giữ nguyên. Thư viện tự động xử lý tuần tự hóa JSON và truyền dữ liệu nếu bạn kích hoạt nó. Phương pháp này lý tưởng cho các dịch vụ backend hoặc các tập lệnh cần xử lý khối lượng lớn văn bản. Mô hình không kiểm duyệt phản hồi với các yêu cầu hoàn thành trò chuyện tiêu chuẩn mà không yêu cầu logic phân tích tùy chỉnh. Cấu hình máy khách của bạn một lần và sử dụng nó trong toàn bộ ứng dụng của bạn. Dưới đây là cách khởi tạo máy khách và gửi một yêu cầu cơ bản.

Thiết lập SDK Node.js

Tích hợp API vào các ứng dụng JavaScript hoặc TypeScript của bạn bằng cách sử dụng @anthropic-ai/sdk hoặc chính thức openai gói. Đặt baseURL đến điểm cuối của chúng tôi và cung cấp khóa API của bạn. Điều này cho phép bạn sử dụng các phương thức quen thuộc như chat.completions.create() trực tiếp. SDK xử lý các yêu cầu HTTP và phân tích các phản hồi JSON cho bạn. Bạn có thể dễ dàng xử lý các lỗi như 402 (không đủ tín dụng) hoặc 429 (giới hạn tốc độ) trong logic ứng dụng của bạn. Cấu hình này hoàn hảo cho máy chủ web, bot hoặc bất kỳ môi trường Node.js nào. Mô hình không kiểm duyệt hoạt động liền mạch với định dạng yêu cầu tiêu chuẩn. Cấu hình máy khách của bạn để đảm bảo tương thích với các yêu cầu của API.

Phản hồi luồng

Bật phân phối token thời gian thực bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Server-Sent Events (SSE), cho phép bạn hiển thị văn bản khi nó được tạo. Điều này cải thiện trải nghiệm người dùng cho các giao diện trò chuyện và giảm độ trễ cảm nhận. Mỗi chunk chứa một phản hồi từng phần, và chunk cuối cùng bao gồm thống kê sử dụng token. Bạn có thể xử lý các chunk này tăng dần để xây dựng phản hồi đầy đủ. Tính năng này rất quan trọng cho các ứng dụng yêu cầu phản hồi ngay lập tức. Mô hình không kiểm duyệt hỗ trợ streaming cho tất cả các loại yêu cầu. Xử lý các sự kiện luồng để cập nhật giao diện người dùng của bạn một cách hiệu quả. Sử dụng mã này để triển khai streaming trong máy khách của bạn.

Giới hạn tốc độ & Giới hạn ngữ cảnh

API áp dụng các giới hạn nghiêm ngặt để đảm bảo hiệu suất ổn định cho tất cả người dùng. Bạn có thể gửi tối đa 300 yêu cầu mỗi phút per key và có 8 yêu cầu đồng thời hoạt động bất cứ lúc nào. Kích thước yêu cầu tối đa là 8 MB. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được 429 mã trạng thái. Đảm bảo bạn xử lý việc thử lại với cơ chế backoff theo cấp số nhân để tránh vượt quá giới hạn này liên tục. Cửa sổ ngữ cảnh là 100,000 token, nhưng đầu ra tối đa là 16,000 token. Nếu bạn cần nhiều đầu ra hơn, hãy điều chỉnh max_tokens tham số. Lỗi như 401 (khóa không hợp lệ) và 402 (không có tín dụng) là ngay lập tức và không tiêu tốn hạn mức token của bạn. Quản lý hạn mức của bạn cẩn thận để tránh gián đoạn dịch vụ trong các tác vụ tạo dữ liệu khối lượng lớn.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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