Tài liệu API cho Hoàn thành trò chuyện không kiểm duyệt

Bắt đầu nhanh: Kết nối bằng Python hoặc JavaScript

Kết nối với API bằng cách cập nhật URL cơ sở của bạn và đặt khóa API của bạn. Điểm cuối chấp nhận các yêu cầu hoàn thành trò chuyện tiêu chuẩn và trả về văn bản. Bạn không cần cài đặt các thư viện tùy chỉnh nếu bạn sử dụng các SDK OpenAI chính thức, vì giao diện khớp chính xác với đặc tả của họ.

Bắt đầu với một yêu cầu HTTP đơn giản để xác minh kết nối. Sử dụng lệnh curl bên dưới để gửi một lời nhắc cơ bản đến uncensored model. Thay thế YOUR_API_KEY với khóa được tạo trên bảng điều khiển của bạn.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Đối với các nhà phát triển Python, quy trình gần như giống hệt nhau. Khởi tạo client với khóa của bạn và URL cơ sở chính xác. Điều này đảm bảo tất cả các yêu cầu được định tuyến qua các máy chủ không kiểm duyệt của chúng tôi trong khi vẫn duy trì khả năng tương thích với các công cụ hiện có.

Copyfrom openai import OpenAI

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

Người dùng JavaScript có thể đạt được kết quả tương tự bằng cách sử dụng SDK Node. Đặt baseURL thuộc tính vào điểm cuối của chúng tôi. Cách tiếp cận này cho phép bạn tích hợp API vào máy chủ web hoặc dịch vụ backend với ít thay đổi mã nhất.

Copyimport OpenAI from "openai";

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

Xác thực và quản lý API Key

Xác thực dựa trên một khóa API đơn lẻ được truyền trong header. Truyền khóa này trong Authorization header cho mọi yêu cầu. Nếu khóa bị thiếu hoặc không hợp lệ, API sẽ trả về lỗi 401 ngay lập tức. Điều này đảm bảo quyền truy cập an toàn vào tín dụng trả trước của bạn.

Tạo khóa của bạn trên bảng điều khiển. Khóa sẽ được hiển thị một lần khi tạo. Hãy lưu trữ nó an toàn trong các biến môi trường của bạn. Không chia sẻ công khai. Mỗi tài khoản chỉ hỗ trợ một khóa hoạt động tại một thời điểm. Việc tạo khóa mới sẽ vô hiệu hóa khóa cũ ngay lập tức.

Sử dụng khóa trong các yêu cầu của bạn như thế này: Authorization: Bearer YOUR_API_KEY. Định dạng tiêu đề chuẩn này hoạt động với tất cả các SDK chính. Hãy giữ khóa của bạn sẵn sàng để lặp lại nhanh chóng trong quá trình phát triển.

Thông số Endpoint Hoàn thành Trò chuyện

Gửi yêu cầu đến /v1/chat/completions endpoint. endpoint. Bao gồm mảng messages của bạn và đặt mô hình thành uncensored. Bạn có thể điều chỉnh các tham số như temperature và top_p để kiểm soát độ sáng tạo. Các giá trị cao hơn tạo ra các phản hồi đa dạng hơn.

Đặt max_tokens để giới hạn độ dài đầu ra. Mặc định là 2.048 token nếu không chỉ định. Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token cho prompt cộng với phần hoàn thiện. Điều này cho phép các cuộc trò chuyện dài mà không bị cắt ngắn. Điều chỉnh presence_penalty và frequency_penalty để giảm sự lặp lại trong các kịch bản nhập vai.

Sử dụng stop tham số để dừng quá trình tạo tại các cụm từ cụ thể. Điều này giúp thực thi cấu trúc hội thoại. Cái seed tham số đảm bảo các đầu ra có thể tái lập cho việc kiểm tra. Các công cụ này cung cấp cho bạn khả năng kiểm soát chính xác hành vi của mô hình.

Phản hồi dạng stream và dữ liệu mức 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 chunk văn bản ngay khi chúng được tạo. Điều này giảm độ trễ cảm nhận đối với người dùng cuối. Mỗi chunk bao gồm văn bản từng phần và siêu dữ liệu.

Dữ liệu sử dụng xuất hiện trong chunk cuối cùng. Điều này bao gồm số lượng token đầu vào và đầu ra. Hãy kiểm tra usage field trong đối tượng phản hồi cuối cùng. Điều này cho phép xác minh hóa đơn chính xác mà không cần các cuộc gọi API riêng biệt. Theo dõi mức tiêu thụ token theo thời gian thực.

Xử lý việc kết thúc luồng cẩn thận. Đảm bảo bạn xử lý tất cả các chunk trước khi đóng kết nối. Chunk cuối cùng chứa thống kê sử dụng đầy đủ. Dữ liệu này rất quan trọng để giám sát chi phí và hiệu suất trong các ứng dụng sản xuất.

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)

Xử lý lỗi và giới hạn tốc độ

API giới hạn 300 yêu cầu mỗi phút trên mỗi khóa. Yêu cầu đồng thời được giới hạn ở tám trên mỗi khóa. Thân yêu cầu không được vượt quá 8 MB. Vượt quá các giới hạn này sẽ trả về lỗi 429. Triển khai cơ chế backoff theo cấp số nhân để xử lý các đỉnh tạm thời.

Các lỗi phổ biến bao gồm 401 cho khóa không hợp lệ và 402 cho tín dụng không đủ. Phản hồi 402 cho biết số dư trả trước của bạn đã cạn kiệt. Hãy nạp thêm tiền vào tài khoản để tiếp tục dịch vụ. Lỗi không tiêu tốn token, vì vậy việc thử lại sau khi khắc phục sự cố là miễn phí.

Kiểm tra thân phản hồi để xem các thông báo lỗi chi tiết. API trả về một đối tượng JSON chứa loại lỗi và thông báo. Hãy sử dụng thông tin này để gỡ lỗi nhanh chóng. Xử lý lỗi đúng cách đảm bảo trải nghiệm mượt mà cho người dùng của bạn trong các giai đoạn lưu lượng truy cập cao.

Hướng dẫn chế độ JSON và gọi hàm

Sử dụng chế độ JSON bằng cách đặt response_format để {"type": "json_object"}. Điều này buộc mô hình xuất ra JSON hợp lệ. Lý tưởng cho việc trích xuất dữ liệu có cấu trúc hoặc phản hồi API. Đảm bảo lời nhắc của bạn mô tả rõ lược đồ mong muốn.

Gọi hàm cho phép mô hình gọi các công cụ. Xác định các công cụ trong thân yêu cầu. Mô hình trả về các lệnh gọi công cụ khi phù hợp. Xử lý các lệnh gọi này trong logic ứng dụng của bạn. Điều này cho phép các quy trình làm việc nhiều bước phức tạp.

Kết hợp chế độ JSON với gọi hàm để tạo các tích hợp mạnh mẽ. Xác thực đầu ra JSON ở phía máy khách. Sử dụng tool_choice tham số để kiểm soát thời điểm các hàm được gọi. Sự linh hoạt này hỗ trợ các kiến trúc ứng dụng đa dạng. Đảm bảo các công cụ của bạn được xác định rõ ràng để có hiệu suất tối ưu.

Chi tiết mô hình và giới hạn cửa sổ ngữ cảnh

The uncensored model hỗ trợ cửa sổ ngữ cảnh 100.000 token. Điều này bao gồm cả lời nhắc đầu vào và phần hoàn thành đầu ra. Đầu ra tối đa là 16.000 token mỗi yêu cầu. Điều này cho phép các kịch bản nhập vai dài mà không bị ngắt quãng giữa câu.

Mô hình là trọng lượng mở và được tinh chỉnh cho nội dung không hạn chế. Nó không từ chối các chủ đề người lớn hợp pháp. Nó không phải là mô hình của GPT, Claude hay bất kỳ nhà cung cấp nào khác. Các yêu cầu được xử lý trên máy chủ chuyên dụng của chúng tôi. Điều này đảm bảo hiệu suất ổn định và độ trễ thấp.

Theo dõi mức sử dụng ngữ cảnh để duy trì trong giới hạn. API theo dõi chính xác việc sử dụng token. Lỗi và từ chối không tiêu thụ token. Mô hình tính phí minh bạch này giúp bạn dự đoán chi phí. Lập kế hoạch cho cửa sổ ngữ cảnh của bạn để tối đa hóa giá trị.