Tài liệu API Tương thích OpenAI

Base URL và Xác thực

Bắt đầu mọi yêu cầu bằng cách đặt base_url để https://api.nsfwgemma.com/v1 và chuyển khóa API của bạn trong Authorization header. Bạn nhận được khóa ngay sau khi đăng ký bằng Google hoặc email, không cần số điện thoại. Giữ khóa này an toàn, vì đây là thông tin xác thực duy nhất cần thiết để truy cập dịch vụ.

POST /v1/chat/completions: Tham số và Ví dụ

Gửi tin nhắn đầu tiên đến điểm cuối bằng cách sử dụng định dạng hoàn tất cuộc trò chuyện tiêu chuẩn. Model ID luôn là "uncensored", và bạn có thể kiểm soát phong cách đầu ra với các tham số như temperature và top_p. Điểm cuối này xử lý tất cả việc tạo văn bản mà không yêu cầu các thiết lập cục bộ phức tạp.

Copycurl https://api.nsfwgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
  }'

Đảm bảo payload của bạn bao gồm model field được đặt thành "uncensored" và một messages mảng chứa prompt của bạn. Hệ thống trả về phản hồi JSON có cấu trúc với văn bản được tạo.

GET /v1/models: Liệt kê các mô hình có sẵn

Truy vấn endpoint models để xác minh phiên bản khả dụng và xác nhận kết nối. Yêu cầu GET này trả về siêu dữ liệu về cấu hình mô hình hiện tại mà không tiêu tốn bất kỳ tín dụng nào. Hãy sử dụng bước này để gỡ lỗi các vấn đề kết nối trước khi gửi các yêu cầu tạo dữ liệu tốn kém.

Copyfrom openai import OpenAI

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

Phản hồi xác nhận ID mô hình và giới hạn token, đảm bảo client của bạn được cấu hình đúng cho mô hình ngôn ngữ lớn không kiểm duyệt.

Phản hồi luồng với SSE

Bật phát trực tiếp bằng cách đặt stream: true để nhận các token theo thời gian thực qua Server-Sent Events. Điều này giảm độ trễ cảm nhận đối với việc sáng tác văn học dài hoặc các kịch bản nhập vai. Thống kê sử dụng token được bao gồm trong chunk cuối cùng của luồng.

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)

Phân tích từng đối tượng delta để hiển thị văn bản theo từng bước, mang lại trải nghiệm người dùng mượt mà hơn cho các ứng dụng bot chat NSFW tương tác.

Xử lý lỗi và Sử dụng token

Xử lý các lỗi HTTP phổ biến một cách mượt mà: 401 cho biết khóa không hợp lệ hoặc đã hết hạn, 402 nghĩa là bạn cần nạp thêm tín dụng, và 429 báo hiệu việc cạn kiệt giới hạn tốc độ. Lỗi không tiêu tốn tín dụng trả trước của bạn, vì vậy bạn có thể thử lại mà không bị phạt. Luôn kiểm tra usage field trong các phản hồi thành công để theo dõi mức tiêu thụ.

Giới hạn tốc độ và Độ đồng thời

Mỗi khóa API hỗ trợ 300 yêu cầu mỗi phút và tối đa 8 yêu cầu đồng thời. Kích thước tối đa của thân yêu cầu là 8 MB, phù hợp với hầu hết các cửa sổ ngữ cảnh tiêu chuẩn. Vượt quá các giới hạn này sẽ kích hoạt lỗi 429 cho đến khi cửa sổ được đặt lại.

Cửa sổ ngữ cảnh cho phép tổng cộng 100.000 token, kết hợp cả prompt và completion. Lượng output tối đa là 16.000 token cho mỗi yêu cầu, hoặc 2.048 nếu bạn không chỉ định max_tokens. Điều chỉnh độ đồng thời của bạn dựa trên các mẫu lưu lượng truy cập của ứng dụng của bạn.

Các tham số được hỗ trợ: Nhiệt độ, Top P và hơn thế nữa

Kiểm soát độ ngẫu nhiên và tính xác định bằng cách sử dụng temperature, top_p, stop, seed, và các tham số hình phạt. Sử dụng response_format được đặt thành {"type": "json_object"} cho đầu ra dữ liệu có cấu trúc. Gọi hàm được hỗ trợ thông qua tools tham số cho các tích hợp nâng cao.

Các tham số này cho phép tinh chỉnh hành vi của mô hình không kiểm duyệt, đảm bảo nó phù hợp với các yêu cầu nội dung NSFW cụ thể của bạn mà không có các từ chối không mong đợi.

Node.js

Copyimport OpenAI from "openai";

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