Tài liệu tham khảo API

Base URL và Xác thực

Sử dụng URL cơ sở chuyên dụng cho tất cả các yêu cầu. Khóa API của bạn xác thực qua Authorization header.

• Base URL: https://api.hereticuncensored.com/v1
• ID Mô hình: uncensored

Truy xuất khóa của bạn từ bảng điều khiển. Nó có hiệu lực ngay lập tức khi tạo.

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

Yêu cầu đầu tiên

Gửi một yêu cầu hoàn thành trò chuyện đơn giản để xác minh khả năng kết nối. Mô hình phản hồi mà không có bộ lọc nội dung tiêu chuẩn cho mục đích người lớn hợp pháp.

• Đặt model để uncensored.
• Bao gồm messages mảng.

Kiểm tra phản hồi để choices chứa văn bản do bạn tạo.

Copyfrom openai import OpenAI

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

Tích hợp SDK Node

Khởi tạo client với URL cơ sở và khóa. Điều này đảm bảo tương thích với các thư viện OpenAI tiêu chuẩn.

• Cài đặt chính thức openai gói.
• Chuyển tiếp baseURL và apiKey trong quá trình khởi tạo.

Gọi chat.completions.create() với lời nhắc của bạn. Cấu trúc phản ánh định dạng API tiêu chuẩn.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.hereticuncensored.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ản hồi luồng

Bật phân phối token thời gian thực bằng cách đặt stream để true. Điều này giảm độ trễ cảm nhận được đối với các đầu ra dài.

• Lắng nghe delta chunks.
• Kết hợp các đoạn dữ liệu để tái tạo lại phản hồi đầy đủ.

Metadata sử dụng token xuất hiện trong chunk cuối cùng. Điều này rất lý tưởng cho các giao diện trò chuyện yêu cầu phản hồi tức thì.

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)

Giới hạn tốc độ và Ngữ cảnh

API hỗ trợ cửa sổ ngữ cảnh 100.000 token. Bạn có thể gửi tối đa 300 yêu cầu mỗi phút cho mỗi khóa.

• Số yêu cầu đồng bộ tối đa: 8
• Token đầu ra tối đa: 16.000 (mặc định 2.048)

Vượt quá giới hạn kích hoạt lỗi 429. Quản lý độ đồng thời để duy trì thông lượng nhất quán cho các khối lượng công việc quy mô lớn.

Xử lý lỗi và Mã lỗi

Xử lý lỗi một cách tinh tế để duy trì sự ổn định của ứng dụng. Các mã phổ biến bao gồm 401 cho khóa không hợp lệ và 402 cho tín dụng không đủ.

• 429 cho thấy cạn kiệt giới hạn tốc độ.
• 400 báo hiệu thân yêu cầu bị lỗi cú pháp.

Hoàn tiền không được phát hành cho các token đã tiêu thụ. Kiểm tra số dư của bạn thường xuyên để tránh gián đoạn dịch vụ.