Bắt đầu nhanh: Kết nối mã của bạn

Cài đặt và cấu hình

Khóa API xác thực các yêu cầu của bạn. Tạo một khóa ngay lập tức qua bảng điều khiển bằng Google hoặc email và mật khẩu. Không cần số điện thoại. Lưu khóa trong các biến môi trường của bạn. Nó cấp quyền truy cập vào mô hình không kiểm duyệt duy nhất. Bạn có thể thay thế khóa nếu cần, nhưng chỉ một khóa vẫn hoạt động tại một thời điểm. URL cơ sở định hướng lưu lượng truy cập đến các máy chủ của chúng tôi. Nó hoạt động với bất kỳ thư viện khách hàng tương thích OpenAI nào. Thay đổi base_url tham số để trỏ vào đây. Điều này loại bỏ logic proxy hoặc định tuyến phức tạp. Các prompt và bản hoàn thành của bạn được tính vào khoản tín dụng trả trước của bạn. Lỗi không tiêu thụ token. Điều này đảm bảo bạn chỉ trả tiền cho quá trình tạo thực tế.

Thực hiện cuộc gọi chat hoàn tất đầu tiên

Gửi yêu cầu POST đến /v1/chat/completions với định danh mô hình của bạn. Sử dụng "uncensored" như giá trị mô hình. Bao gồm các thông điệp hệ thống và người dùng của bạn trong messages mảng. API trả về văn bản đã được tạo. Không có bộ lọc nội dung chặn các chủ đề người lớn hợp pháp. Bạn có thể điều chỉnh các tham số như temperature hoặc top_p. Những điều này kiểm soát độ ngẫu nhiên và sáng tạo. Đặt max_tokens để giới hạn độ dài đầu ra. Mặc định là 2.048 token. Bạn có thể mở rộng điều này lên đến 16.000 token. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token. Điều này cho phép các vai diễn dài, chi tiết. Hãy giữ các yêu cầu của bạn dưới 8 MB. Giới hạn này đảm bảo hiệu suất ổn định cho các trọng tải lớn.

Xử lý phản hồi phát trực tiếp

Streaming gửi các token khi chúng được tạo. Điều này giảm độ trễ cảm nhận đối với người dùng. Đặt stream: true trong yêu cầu của bạn. API trả về luồng Server-Sent Events (SSE). Mỗi chunk chứa nội dung từng phần. Bạn có thể nối các chunk này để tạo thành phản hồi đầy đủ. Chunk cuối cùng bao gồm thống kê sử dụng token. Điều này giúp bạn theo dõi chính xác việc tiêu thụ tín dụng. Streaming lý tưởng cho các giao diện trò chuyện thời gian thực. Nó cung cấp phản hồi ngay lập tức trong quá trình tạo. Xử lý lỗi vẫn nhất quán bất kể có streaming hay không. Kiểm tra mã trạng thái cho các lỗi. Lỗi 402 cho biết không đủ tín dụng. Lỗi 401 có nghĩa là khóa của bạn không hợp lệ. Logic thử lại nên tính đến các mã cụ thể này.

Sử dụng gọi hàm và công cụ

Định nghĩa các công cụ trong yêu cầu của bạn để kích hoạt gọi hàm. Mô hình có thể trả về dữ liệu có cấu trúc cho ứng dụng của bạn. Chỉ định tool_choice để kiểm soát hành vi gọi. Sử dụng "auto" cho việc lựa chọn tự động. Truyền các định nghĩa công cụ trong tools mảng. Mô hình phản hồi với các lệnh gọi hàm khi thích hợp. Bạn thực thi hàm và gửi kết quả trở lại. Mô hình tiếp tục cuộc trò chuyện dựa trên đầu ra. Điều này hỗ trợ logic phức tạp trong các bot đóng vai. Bạn có thể xác định nhiều công cụ cho các hành động khác nhau. API xử lý việc phân tích cú pháp và định tuyến. Đảm bảo lược đồ công cụ của bạn là JSON hợp lệ. Điều này ngăn ngừa lỗi trong quá trình gọi hàm.

Đang thực thi chế độ JSON

Buộc mô hình xuất ra JSON hợp lệ. Đặt response_format để {"type": "json_object"}. Điều này đảm bảo dữ liệu có cấu trúc để phân tích cú pháp. Sử dụng điều này cho trạng thái trò chơi hoặc phản hồi API. Mô hình sẽ không thêm định dạng markdown. Nó chỉ trả về JSON thô. Điều này hữu ích cho các quy trình tự động hóa. Bạn có thể phân tích cú pháp đầu ra trực tiếp trong mã của mình. Lỗi trong cấu trúc JSON là hiếm nhưng có thể xảy ra. Xác thực đầu ra ở lớp ứng dụng của bạn. Điều này thêm một mạng an toàn cho các hệ thống sản xuất. Chế độ JSON hoạt động cùng với gọi hàm. Bạn có thể kết hợp cả hai cho các tương tác phức tạp. Cửa sổ ngữ cảnh áp dụng cho toàn bộ cuộc trao đổi. Hãy lập kế hoạch sử dụng token của bạn phù hợp để nằm trong giới hạn.

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

Bạn bị giới hạn 300 yêu cầu mỗi phút cho mỗi khóa. Yêu cầu đồng thời được giới hạn ở 8 cho mỗi khóa. Thân yêu cầu không được vượt quá 8 MB. Các giới hạn này ngăn quá tải máy chủ trong thời gian sử dụng cao điểm. Lỗi trả về các mã trạng thái HTTP tiêu chuẩn. 401 cho biết khóa không hợp lệ hoặc đã hết hạn. 402 báo hiệu rằng số dư trả trước của bạn đã cạn kiệt. 429 có nghĩa là bạn đã vượt quá giới hạn tốc độ. Hãy đợi trước khi thử lại sau lỗi 429. Cửa sổ ngữ cảnh là 100.000 token. Điều này bao gồm cả token prompt và token hoàn thành. Các cuộc hội thoại dài có thể cần chiến lược cắt ngắn. Quản lý việc sử dụng token của bạn để tránh chi phí không mong muốn. Tín dụng không bao giờ hết hạn, vì vậy bạn có thể tạm dừng sử dụng bất cứ lúc nào. Sự linh hoạt này phù hợp với việc tạo dữ liệu khối lượng cao theo từng đợt.

cURL

Copycurl https://api.restrictionsnoai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List three spicy dialogue lines for a vampire character"}]
  }'

Python

Copyfrom openai import OpenAI

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