Xác thực
Xác thực được xử lý thông qua một khóa API duy nhất. Bạn có thể đăng ký bằng Google hoặc mật khẩu email trên trang Lấy khóa API. Khóa được hiển thị ngay lập tức và được liên kết với tín dụng trả trước của bạn. Không giống như các nhà cung cấp lớn, không có gói đăng ký hàng tháng hoặc thẻ tín dụng nào được yêu cầu cho bản dùng thử. Sử dụng tiêu đề Authorization: Bearer YOUR_API_KEY cho tất cả các yêu cầu. Khóa của bạn là thông tin xác thực hoạt động duy nhất cho mỗi tài khoản; việc tạo khóa mới sẽ vô hiệu hóa khóa trước đó.
Hoàn tất cơ bản
Gửi yêu cầu hoàn thành trò chuyện tiêu chuẩn đến endpoint tương thích OpenAI. Định danh mô hình là uncensored. Đây là mô hình trọng số mở, được tinh chỉnh để trả lời mà không từ chối nội dung cho việc sử dụng người lớn hợp pháp. Mô hình này không phải GPT, Claude hay bất kỳ mô hình của nhà cung cấp nào khác. URL cơ sở cho dịch vụ này được cung cấp bên dưới.
curl https://api.ornith.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."}]
}'Thay thế YOUR_API_KEY bằng khóa của bạn từ bảng điều khiển. Phản hồi bao gồm văn bản được tạo trong choices[0].message.content. Lỗi như 401 cho biết khóa không hợp lệ, trong khi 402 có nghĩa là tín dụng trả trước của bạn đã hết.
SDK Python
Sử dụng gói Python chính thức openai. Trỏ nó đến URL cơ sở của Ornith và cung cấp khóa API của bạn. Điều này đảm bảo tương thích với cấu trúc máy khách OpenAI tiêu chuẩn. Bạn có thể truyền các thông báo dưới dạng danh sách các từ điển chứa role và content. Máy khách xử lý các yêu cầu HTTP một cách tự động. Cách tiếp cận này hoạt động cho cả việc tạo văn bản đơn giản và các tương tác phức tạp hơn sử dụng công cụ hoặc chế độ JSON.
from openai import OpenAI
client = OpenAI(base_url="https://api.ornith.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)Đối tượng phản ánh cấu trúc OpenAI tiêu chuẩn. Bạn có thể truy cập trực tiếp văn bản được tạo ra từ đối tượng phản hồi. Phương pháp này lý tưởng cho các dịch vụ backend hoặc kịch bản nơi bạn cần truy cập lập trình vào đầu ra của mô hình.
SDK Node.js
Cài đặt gói npm openai. Khởi tạo client với URL cơ sở Ornith và khóa API của bạn. Cấu trúc của yêu cầu giống hệt với SDK Python. Sử dụng phương thức chat.completions.create. Điều này phù hợp cho các môi trường JavaScript, cho dù bạn đang xây dựng backend web hay công cụ CLI. Client xử lý việc tuần tự hóa và giải mã hóa phản hồi.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ornith.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ý lỗi thích hợp. Lỗi mạng hoặc lỗi API sẽ ném ra ngoại lệ. Kiểm tra mã trạng thái để phân biệt giữa lỗi xác thực, giới hạn tốc độ hoặc lỗi máy chủ. Phản hồi chứa chi tiết hoàn thành theo cùng định dạng như SDK Python.
Phản hồi truyền phát
Bật truyền phát bằng cách đặt stream: true trong yêu cầu của bạn. Điều này trả về một luồng token khi chúng được tạo. Sử dụng điều này cho các cập nhật giao diện người dùng theo thời gian thực hoặc hiển thị văn bản từng phần. Luồng kết thúc bằng một phần cuối chứa tổng mức sử dụng token. Điều này cho phép bạn theo dõi chi phí theo thời gian thực mà không cần đợi phản hồi đầy đủ. Nó hiệu quả cho các ngữ cảnh dài nơi bạn muốn hiển thị tiến trình.
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)Duyệt qua luồng để xử lý từng phần. Phần cuối bao gồm trường usage. Điều này hữu ích cho tính minh bạch về hóa đơn. Đảm bảo máy khách của bạn xử lý luồng đúng cách để tránh các vấn đề về bộ nhớ với các phản hồi lớn.
Giới hạn, Lỗi & Ngữ cảnh
Cửa sổ ngữ cảnh là 100.000 token cho prompt và phần hoàn tất kết hợp. Lượng đầu ra tối đa mỗi yêu cầu là 32.000 token (2.048 nếu max_tokens không được đặt). 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 phải dưới 8 MB. Nếu bạn vượt quá giới hạn tốc độ, bạn sẽ nhận được lỗi 429. Việc từ chối nội dung liên quan đến người chưa thành niên được mã hóa cứng và luôn áp dụng. Lỗi không tiêu tốn tín dụng. Tín dụng là tín dụng trả trước và không bao giờ hết hạn.
