Tài liệu tham khảo API GitHub Uncensored AI
Tích hợp LLM không kiểm duyệt vào các ứng dụng của bạn với một điểm cuối tương thích OpenAI tiêu chuẩn. Bạn nhận được việc tạo văn bản ngay lập tức mà không có bộ lọc nội dung, thanh toán crypto trả trước và cửa sổ ngữ cảnh 100.000 token.
Xác thực & Base URL
API yêu cầu một mã thông báo bearer cho mọi yêu cầu. Bạn tạo khóa này ngay lập tức qua bảng điều khiển bằng thông tin đăng nhập Google hoặc email. Sau khi được tạo, khóa sẽ xác thực tài khoản trả trước của bạn với mô hình được lưu trữ.
Thiết lập URL cơ sở của bạn trỏ trực tiếp đến cổng API của chúng tôi. Điều này đảm bảo mọi yêu cầu được định tuyến đến máy chủ mô hình không kiểm duyệt chính xác.
Sử dụng header Authorization tiêu chuẩn với scheme Bearer. Thay thế phần giữ chỗ bằng chuỗi key duy nhất của bạn.
Cấu hình Base
- Base URL:
https://api.githubuncensoredai.com/v1 - Tiêu đề Auth:
Authorization: Bearer YOUR_API_KEY - ID Mô hình:
uncensored
curl https://api.githubuncensoredai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix the syntax error in this python loop"}]
}'
Endpoint Hoàn thành Trò chuyện
Gửi dữ liệu văn bản đến điểm cuối hoàn tất trò chuyện và nhận văn bản được tạo làm phản hồi. Hệ thống chấp nhận một danh sách các thông điệp với các vai trò như user hoặc assistant. Nó trả về một kết thúc dựa trên lịch sử prompt.
Điểm cuối này xử lý các luồng hội thoại tiêu chuẩn. Bạn có thể gửi nhiều lượt, và mô hình duy trì ngữ cảnh lên đến giới hạn. Nó không hỗ trợ đầu vào hình ảnh, âm thanh hoặc video. Định dạng phản hồi là JSON tiêu chuẩn.
Đảm bảo payload của bạn bao gồm định danh mô hình. Hệ thống bỏ qua các trường không xác định một cách linh hoạt. Lỗi trả về các mã cụ thể nếu xác thực thất bại hoặc hết tín dụng.
from openai import OpenAI
client = OpenAI(base_url="https://api.githubuncensoredai.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 luồng
Bật chế độ streaming bằng cách đặt cờ stream thành true. API trả về một chuỗi các sự kiện Server-Sent Events thay vì một đối tượng JSON đơn lẻ. Mỗi sự kiện chứa một chunk của văn bản được tạo.
Cách tiếp cận này giảm độ trễ cảm nhận đối với các phản hồi dài. Bạn có thể bắt đầu hiển thị văn bản cho người dùng khi nó được tạo ra. Chunk cuối cùng bao gồm thống kê sử dụng token để tính phí.
Xử lý luồng một cách hiệu quả trong mã client. Đóng kết nối khi luồng kết thúc hoặc xảy ra lỗi. Phương pháp này hoạt động tốt cho các giao diện trò chuyện thời gian thực.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.githubuncensoredai.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);
Gọi hàm & Chế độ JSON
Mô hình hỗ trợ đầu ra có cấu trúc thông qua gọi hàm. Xác định các công cụ trong yêu cầu của bạn với tên, mô tả và lược đồ tham số. Mô hình chọn công cụ phù hợp và tạo đối số.
Sử dụng chế độ JSON để tuân thủ nghiêm ngặt lược đồ. Đặt định dạng phản hồi thành json_object để buộc đầu ra JSON hợp lệ. Điều này hữu ích cho việc phân tích cú pháp dữ liệu hoặc tạo các đoạn mã.
Kết hợp gọi hàm với streaming cho các trải nghiệm tương tác. Mô hình có thể gọi nhiều công cụ theo trình tự. Xác thực lược đồ đầu ra trước khi thực thi các hàm trong logic ứng dụng của bạn.
stream = 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)
Tham số & Giới hạn
Kiểm soát hành vi sinh văn bản với các tham số như temperature và top_p. Điều chỉnh các giá trị này để cân bằng giữa sáng tạo và tính xác định. Các cài đặt mặc định phù hợp cho hầu hết các mục đích chung.
Hãy tôn trọng các giới hạn yêu cầu để tránh lỗi. Bạn có thể gửi tối đa 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. Kích thước tối đa của thân yêu cầu là 8 MB.
Cửa sổ ngữ cảnh trải rộng 100.000 token. Điều này bao gồm cả token lời nhắc và token hoàn thành. Đầu ra bị giới hạn ở 16.000 token mỗi yêu cầu. Vượt quá các giới hạn này sẽ trả về mã lỗi.
Sử dụng Token & Hóa đơn
Thanh toán là trả trước và dựa trên lượng token thực tế. Token đầu vào tốn $0.15 cho mỗi triệu, và token đầu ra tốn $0.50 cho mỗi triệu. Lỗi và từ chối không tiêu thụ tín dụng.
Tín dụng không bao giờ hết hạn. Việc nạp tiền chỉ được thực hiện qua tiền điện tử. Bạn nhận được tín dụng thưởng cho các khoản nạp lớn. Hệ thống theo dõi chính xác mức sử dụng cho từng khóa API.
Theo dõi số dư của bạn qua bảng điều khiển. Nếu tín dụng thấp, các yêu cầu của bạn sẽ bị lỗi với một mã lỗi cụ thể. Thêm tiền ngay lập tức để tiếp tục dịch vụ mà không cần chờ phê duyệt.
Các câu hỏi thường gặp
Làm thế nào để xử lý lỗi xác thực?
Nếu bạn nhận được lỗi 401, khóa API của bạn không hợp lệ hoặc đã hết hạn. Hãy kiểm tra bảng điều khiển để đảm bảo khóa còn hoạt động. Tạo lại khóa nếu cần. Đảm bảo bạn đang sử dụng đúng URL cơ sở và định dạng tiêu đề.
Điều gì xảy ra nếu hết hạn mức tín dụng?
Yêu cầu sẽ trả về lỗi 402 cho biết số dư không đủ. Không có token nào được tính cho những nỗ lực thất bại này. Nạp lại số dư tiền điện tử của bạn để tiếp tục dịch vụ ngay lập tức. Tín dụng không hết hạn, vì vậy bạn có thể thêm tiền bất cứ khi nào thuận tiện.
API có bị giới hạn tốc độ không?
Có, bạn bị giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa. Vượt quá giới hạn này sẽ trả về lỗi 429. Hãy sử dụng streaming để giảm số lượng yêu cầu cho các phản hồi dài. Theo dõi việc sử dụng để tránh bị hạn chế tốc độ.
Tạo khóa của bạn trong vài giây
Đăng ký, lấy khóa của bạn, cập nhật URL cơ sở. Xong.