Hướng dẫn bắt đầu nhanh & Tích hợp API

Base URL và Xác thực

Dự án Heretic cung cấp một điểm cuối lưu trữ duy nhất cho việc tạo văn bản. Sử dụng https://api.hereticproject.com/v1 làm URL cơ sở. Xác thực dựa trên một mã thông báo bearer được truyền qua Authorization header. Tạo khóa của bạn bằng cách đăng nhập bằng Google hoặc email trên bảng điều khiển. Hệ thống cấp một khóa hoạt động cho mỗi tài khoản; tạo khóa mới sẽ vô hiệu hóa khóa trước đó ngay lập tức.

Bạn chỉ trả phí cho token đã sử dụng. Lỗi và từ chối không tính vào số dư trả trước của bạn. Tài khoản mới nhận được $0.50 tiền dùng thử có hiệu lực trong bảy ngày. Bạn nạp tiền bằng USDT (TRC20) hoặc USDC (Base) với số tiền từ $20 đến $500.

Điểm cuối /v1/chat/completions

Gửi tin nhắn đến endpoint hoàn thành chat tiêu chuẩn. Model ID là uncensored. Nó chấp nhận một danh sách các đối tượng thông điệp với các vai trò như system, user, hoặc assistant. Mô hình không từ chối các chủ đề người lớn hợp pháp, hư cấu hoặc gây tranh cãi. Đó là một mô hình trọng lượng mở được tinh chỉnh để đưa ra câu trả lời trực tiếp.

Yêu cầu trả về một đối tượng JSON chứa văn bản được tạo. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100,000 token cho prompt và kết hợp. Đầu ra bị giới hạn ở 16,000 token mỗi yêu cầu trừ khi bạn chỉ định mức thấp hơn max_tokens giá trị.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI với URL cơ sở tùy chỉnh. Đặt api_key đến chuỗi API của bạn. Cấu hình base_url để trỏ đến máy chủ của Heretic Project. Điều này cho phép bạn sử dụng các phương thức quen thuộc như chat.completions.create() không thay đổi đáng kể cấu trúc mã hiện có của bạn.

Cài đặt thư viện qua pip. Truyền thông tin xác thực trực tiếp vào quá trình khởi tạo client. Thư viện xử lý serialization tự động. Cách tiếp cận này hoạt động cho cả quy trình đồng bộ và bất đồng bộ. Đảm bảo bạn xử lý các lỗi mạng tiềm ẩn một cách khéo léo.

Copyfrom openai import OpenAI

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

SDK Node.js hoạt động giống hệt phiên bản Python. Khởi tạo máy khách với khóa API và URL cơ sở chính xác của bạn. Bạn có thể gửi yêu cầu hoàn tất bằng các chữ ký phương thức giống nhau. Điều này đảm bảo tính nhất quán giữa các phần khác nhau trong hệ thống của bạn.

Xử lý phản hồi bất đồng bộ. SDK phát dữ liệu nếu bạn sử dụng phương thức phát trực tiếp. Nếu không, nó sẽ trả về phản hồi JSON đầy đủ. Sự linh hoạt này hỗ trợ cả xử lý hàng loạt và giao diện thời gian thực. Giữ khóa API của bạn an toàn trong các biến môi trường.

Copyimport OpenAI from "openai";

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

Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. Máy chủ gửi Server-Sent Events (SSE). Mỗi chunk chứa các cập nhật văn bản một phần. Điều này giảm độ trễ cảm nhận cho người dùng cuối. Dữ liệu sử dụng token xuất hiện trong chunk cuối cùng của luồng.

Xử lý từng đối tượng delta để tích lũy phản hồi đầy đủ. Ngừng lắng nghe khi luồng đóng hoặc xảy ra lỗi. Phương pháp này lý tưởng cho giao diện trò chuyện. Nó cho phép người dùng thấy suy nghĩ đang hình thành theo thời gian thực. Chi phí hoạt động rất thấp so với các phản hồi đầy đủ.

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, Lỗi và Ngữ cảnh

Hãy tôn trọng các giới hạn tốc độ để tránh gián đoạn dịch vụ. Bạn được phép 300 yêu cầu mỗi phút trên mỗi khóa. Độ đồng thời giới hạn ở 8 yêu cầu đồng thời. 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ề mã trạng thái 429. Hãy đợi một chút trước khi thử lại.

Lỗi xác thực trả về lỗi 401. Điều này xảy ra nếu khóa không hợp lệ hoặc đã hết hạn. Lỗi 402 cho biết tín dụng trả trước không đủ. Các lỗi hoàn tiền được xử lý qua trang Hỗ trợ. Tín dụng không bao giờ hết hạn. Mô hình từ chối nội dung liên quan đến trẻ vị thành niên. Tất cả các nội dung hợp pháp khác đều được chấp nhận.