Tài liệu tham khảo & Hướng dẫn nhanh API

Xác thực và Base URL

Sử dụng khóa API của bạn với URL cơ sở https://api.chatuncensored.cc/v1. Truyền khóa trong Authorization header dưới dạng mã Bearer. Cấu hình này hoạt động với bất kỳ SDK hoặc khách hàng tương thích OpenAI nào.

Tạo khóa của bạn trên bảng điều khiển qua Google hoặc email. Hãy giữ nó an toàn. Bạn nhận được $0.50 có hiệu lực trong 7 ngày. Hãy sử dụng khoản này để kiểm tra kết nối trước khi nạp tiền bằng tiền điện tử.

POST /v1/chat/completions

Gửi văn bản đến mô hình bằng cách sử dụng điểm cuối hoàn tất hội thoại. Chỉ định ID mô hình là uncensored. Mô hình trọng lượng mở này phản hồi mà không từ chối nội dung người lớn hợp pháp.

Đính kèm lời nhắc hệ thống để hướng dẫn hành vi. Đặt thông báo người dùng với truy vấn của bạn. API trả về kết quả văn bản trực tiếp.

Cấu hình các tham số như nhiệt độ hoặc top_p để có kết quả đa dạng. Mô hình xử lý ngữ cảnh lên đến 100,000 token kết hợp.

Lỗi như từ chối hoặc sự cố mạng không tiêu thụ tín dụng. Bạn chỉ trả tiền cho việc tạo token thành công.

Cách sử dụng Python SDK

Cài đặt thư viện Python chính thức của OpenAI. Cấu hình URL cơ sở trỏ đến API của chúng tôi. Đặt khóa API trong môi trường hoặc client.

Tạo một phiên bản client. Gọi chat.completions.create với model và messages. Lấy câu trả lời của trợ lý từ đối tượng phản hồi.

Xử lý ngoại lệ cho giới hạn tốc độ hoặc khóa không hợp lệ. SDK đơn giản hóa việc phân tích JSON và định dạng yêu cầu.

Thử nghiệm với tín dụng dùng thử trước. Xác minh cấu trúc phản hồi phù hợp với kỳ vọng trước khi mở rộng sử dụng.

Tích hợp SDK Node

Nhập gói Node của OpenAI. Khởi tạo máy khách với URL cơ sở và khóa của bạn. Xác định mô hình là uncensored.

Gọi phương thức completion với mảng thông báo của bạn. Chờ phản hồi để nhận văn bản được tạo. Điều này hoạt động liền mạch với các hàm bất đồng bộ.

Sử dụng chế độ JSON bằng cách đặt response_format để {"type": "json_object"}. Đảm bảo đầu ra của bạn là JSON hợp lệ để sử dụng lập trình.

Theo dõi mức sử dụng qua các token phản hồi. Theo dõi số lượng đầu vào và đầu ra để quản lý số dư trả trước của bạn một cách hiệu quả.

Streaming, Công cụ và Chế độ JSON

Bật phát trực tiếp bằng cách đặt stream true. Nhận các phần qua các Sự kiện được gửi bởi máy chủ. Xử lý từng token khi nó đến để có độ trễ thấp.

Hỗ trợ gọi hàm với các công cụ và tool_choice. Xác định lược đồ cho các API bên ngoài. Mô hình trả về các đối số có cấu trúc để thực thi.

Sử dụng chế độ JSON cho các định dạng đầu ra nghiêm ngặt. Đặt response_format để đảm bảo các phản hồi JSON hợp lệ. Điều này giảm lỗi phân tích cú pháp trong các quy trình tự động.

Kết hợp streaming với công cụ cho các trải nghiệm tương tác. Cập nhật giao diện người dùng từng token một. Giữ chân người dùng với việc tạo dữ liệu theo thời gian thực.

Giới hạn tốc độ và Mã lỗi

Dự kiến 300 yêu cầu mỗi phút mỗi key. Giới hạn yêu cầu đồng thời là 8. Kích thước body yêu cầu phải dưới 8 MB.

Xử lý lỗi 401 bằng cách xác minh khóa API của bạn. Kiểm tra lỗi chính tả hoặc khóa đã hết hạn. Tạo lại nếu cần thiết.

Nhận 402 khi hết tín dụng. Nạp tiền bằng USDT hoặc USDC. Tín dụng không bao giờ hết hạn. Thêm bonus +15% cho khoản nạp $200.

Gặp lỗi 429 do giới hạn tốc độ. Triển khai cơ chế backoff theo cấp số nhân. Thử lại sau độ trễ được chỉ định. Theo dõi mức sử dụng để tránh gián đoạn.

cURL

Copycurl https://api.chatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set user role to beta tester for the new chat interface"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)