Tài liệu API

Xác thực và Base URL

API yêu cầu một mã thông báo bearer cho mọi yêu cầu. Hãy tạo khóa của bạn trên trang Lấy khóa API bằng cách đăng nhập bằng Google hoặc mật khẩu email. Khóa sẽ xuất hiện ngay lập tức mà không cần xác minh số điện thoại. Sử dụng URL cơ sở https://api.uncensoredaigithub.com/v1 với các SDK chính thức của OpenAI bằng cách cập nhật base_url và api_key giá trị. Cấu hình này hoạt động với bất kỳ máy khách tương thích OpenAI nào.

Điểm cuối: https://api.uncensoredaigithub.com/v1

Tiêu đề Auth: Authorization: Bearer YOUR_API_KEY

Mỗi tài khoản hỗ trợ một khóa hoạt động. Việc phát hành khóa mới sẽ tự động vô hiệu hóa khóa trước đó. Điều này ngăn ngừa sự trôi token khi bạn xoay đổi thông tin xác thực trên các môi trường khác nhau.

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

Gửi các yêu cầu văn bản đến /v1/chat/completions endpoint sử dụng ID mô hình uncensored. API chấp nhận các tin nhắn trò chuyện tiêu chuẩn và trả về các phản hồi văn bản mà không có bộ lọc nội dung cho việc sử dụng người lớn hợp pháp. Bạn có thể định cấu hình các tham số như temperature, top_p, và stop để kiểm soát sự sáng tạo và độ dài đầu ra.

Cửa sổ ngữ cảnh cho phép lên đến 100.000 token cho prompt và completion kết hợp. Đặt max_tokens để kiểm soát đầu ra, với giá trị mặc định là 2,048 token nếu bỏ qua. Lỗi và từ chối không tiêu thụ tín dụng, vì vậy bạn có thể kiểm tra an toàn.

Phản hồi luồng và dữ liệu sử dụ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. API trả về các Sự kiện gửi từ máy chủ (SSE) chứa các chunk văn bản từng phần. Dữ liệu sử dụng token chỉ xuất hiện trong chunk cuối cùng của luồng. Điều này cho phép hiển thị phản hồi theo thời gian thực trong khi theo dõi mức tiêu thụ chính xác.

Streaming rất lý tưởng cho các ứng dụng nhập vai hoặc tạo nội dung dạng dài. Bạn có thể phân tích luồng SSE để cập nhật giao diện người dùng theo từng bước. API đảm bảo các chỉ số sử dụng vẫn chính xác ngay cả khi kết nối bị ngắt sớm.

Function Calling và các công cụ

Hỗ trợ gọi hàm bằng cách cung cấp một tools mảng trong yêu cầu. Mô hình có thể trả về các lệnh gọi công cụ có cấu trúc với các đối số. Sử dụng tool_choice để bắt buộc các hành vi cụ thể, chẳng hạn như thực thi hàm tự động. Tính năng này cho phép tích hợp với các dịch vụ bên ngoài hoặc logic tùy chỉnh.

Định nghĩa các hàm với tên, mô tả và lược đồ tham số. API trả về tên hàm và các đối số trong phản hồi. Phân tích các đối số này để thực thi mã tùy chỉnh của bạn. Khả năng này làm cho API LLM không kiểm duyệt phù hợp cho các quy trình làm việc agent phức tạp.

Chế độ JSON và tham số

Buộc đầu ra có cấu trúc bằng cách đặt response_format để {"type": "json_object"}. Mô hình sẽ trả về JSON thay vì văn bản thuần túy. Điều này hữu ích cho việc trích xuất dữ liệu hoặc tạo cấu hình. Kết hợp điều này với gọi hàm cho các tích hợp API mạnh mẽ.

Các tham số được hỗ trợ khác bao gồm seed để đầu ra xác định, presence_penalty, và frequency_penalty. Sử dụng seed để tái tạo các phản hồi cụ thể nhằm gỡ lỗi. Điều chỉnh các hình phạt để giảm sự lặp lại hoặc khuyến khích từ vựng đa dạng trong đầu ra của bạn.

Xử lý lỗi và Giới hạn

API giới hạn tốc độ 300 yêu cầu mỗi phút và 8 yêu cầu đồng bộ mỗi khóa. Kích thước thân yêu cầu không được vượt quá 8 MB. Nếu vượt quá giới hạn này, bạn sẽ nhận mã trạng thái 429. Lỗi xác thực trả về lỗi 401. Không đủ tín dụng kích hoạt lỗi 402.

Số dư được tính dựa trên việc sử dụng token thực tế. Số dư trả trước không bao giờ hết hạn, vì vậy bạn không cần lo lắng về việc gia hạn hàng tháng. Sử dụng trang Hỗ trợ để giải quyết các vấn đề như tính phí kép.

cURL

Copycurl https://api.uncensoredaigithub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the unit tests for the new auth module."}]
  }'

Python

Copyfrom openai import OpenAI

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