URL cơ sở & Xác thực
Để bắt đầu sử dụng mô hình AI unhinged, bạn cần một khóa API hợp lệ. Tạo khóa này ngay lập tức qua Google hoặc email trên trang Lấy khóa API. Không cần số điện thoại và khóa được hiển thị ngay lập tức.
Đặt base URL của bạn thành https://api.unhinged.top/v1. Mọi yêu cầu đều phải bao gồm tiêu đề Authorization với lược đồ Bearer. Cấu hình này hoạt động với bất kỳ SDK tương thích OpenAI nào. API cung cấp một LLM không kiểm duyệt trực tuyến, được tối ưu hóa cho việc tạo văn bản trực tiếp mà không có các lớp định tuyến bổ sung.
Yêu cầu đầu tiên
Gửi một yêu cầu hoàn thành trò chuyện tiêu chuẩn để kiểm tra tích hợp. ID mô hình luôn là uncensored. Endpoint này trả về văn bản thô mà không có từ chối nội dung cho mục đích người lớn hợp pháp. Nếu bạn vượt quá giới hạn, API sẽ trả về một mã lỗi rõ ràng.
curl https://api.unhinged.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Yêu cầu POST đơn giản này minh họa bản chất đầu vào văn bản, đầu ra văn bản trực tiếp của dịch vụ. Bạn có thể điều chỉnh các tham số như temperature để kiểm soát tính sáng tạo. Phản hồi bao gồm việc sử dụng token, giúp bạn theo dõi chi phí so với mô hình giá cả minh bạch.
Tích hợp SDK Python
Sử dụng SDK Python chính thức của OpenAI để tương tác với API. Cấu hình URL cơ sở và khóa API trong khởi tạo client của bạn. Cách tiếp cận này cho phép bạn giữ nguyên cấu trúc mã hiện có trong khi thay thế bằng mô hình không kiểm duyệt.
from openai import OpenAI
client = OpenAI(base_url="https://api.unhinged.top/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)Các nhà phát triển Python được hưởng lợi từ tính chất đồng bộ của đoạn mã này. Nó xử lý vòng đời yêu cầu một cách tự động. Đảm bảo bạn xử lý các ngoại lệ cho giới hạn tốc độ hoặc lỗi xác thực. Mô hình hỗ trợ lên đến 100.000 token trong cửa sổ ngữ cảnh, cho phép lịch sử prompt đáng kể.
Tích hợp SDK Node.js
Đối với môi trường JavaScript và TypeScript, SDK Node.js mang lại sự dễ sử dụng tương tự. Khởi tạo client với URL cơ sở và khóa của bạn. Điều này cho phép tạo mẫu nhanh các tính năng AI trong các ứng dụng web hoặc dịch vụ backend.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unhinged.top/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ử lý bất đồng bộ được tích hợp sẵn trong SDK. Bạn có thể chờ phản hồi trực tiếp. Mẫu này lý tưởng cho việc hiển thị phía máy chủ hoặc các endpoint API cần trả về kết quả mô hình cho khách hàng. Hãy nhớ rằng API không kiểm duyệt chỉ giới hạn ở việc tạo văn bản; không mong đợi hỗ trợ hình ảnh hoặc âm thanh trong endpoint này.
Phản hồi truyền phát
Để có trải nghiệm độ trễ thấp hơn, hãy bật streaming bằng cách đặt stream: true. API trả về các Sự kiện được gửi bởi máy chủ (SSE). Mỗi chunk chứa văn bản từng phần. Chunk cuối cùng bao gồm tóm tắt sử dụng token đầy đủ.
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)Truyền phát (streaming) rất cần thiết cho các giao diện giống như trò chuyện nơi người dùng mong đợi phản hồi theo thời gian thực. Phân tích các trường choices[0].delta.content để tái tạo lại phản hồi đầy đủ. Phương pháp này giảm đáng kể thời gian để nhận token đầu tiên so với các phản hồi đồng bộ đầy đủ.
Giới hạn, Lỗi & Ngữ cảnh
API áp dụng các hạn ngạch nghiêm ngặt để đảm bảo tính ổn định. 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. Thân yêu cầu không được vượt quá 8 MB. Nếu bạn vượt quá các giới hạn này, bạn sẽ nhận được lỗi 429.
Lỗi xác thực trả về 401 nếu khóa không hợp lệ. Nếu tín dụng trả trước của bạn đã hết, API sẽ trả về 402. Lỗi và từ chối nội dung đều miễn phí, vì vậy bạn chỉ phải trả tiền cho việc sử dụng token thành công. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token, với tối đa 32.000 token mỗi yêu cầu.
