Hướng dẫn bắt đầu nhanh với API

Base URL và Xác thực

Bắt đầu bằng cách trỏ client của bạn đến URL cơ sở của chúng tôi và truyền khóa của bạn trong tiêu đề. Chúng tôi sử dụng cơ chế Authorization tiêu chuẩn nên bất kỳ SDK OpenAI hoặc client tương thích nào cũng sẽ hoạt động ngay lập tức. Bạn không cần quản lý các luồng OAuth phức tạp hay chờ phê duyệt. Chỉ cần đăng ký bằng Google hoặc email, sao chép khóa và bạn đã sẵn sàng. Điểm cuối là https://api.aiohnezensur.com/v1 và chấp nhận Authorization: Bearer YOUR_API_KEY header trên mọi yêu cầu.

Gửi yêu cầu đầu tiên của bạn

Thực hiện lệnh gọi hoàn thành trò chuyện đơn giản để kiểm tra mô hình không hạn chế. Yêu cầu này gửi một lời nhắc và nhận phản hồi văn bản mà không có các hàng rào bảo vệ doanh nghiệp thông thường. Bạn có thể sử dụng bất kỳ công cụ nào hỗ trợ giao thức OpenAI, nhưng lệnh gọi curl trực tiếp sẽ cho thấy chính xác những gì đang diễn ra bên trong. Thay thế YOUR_API_KEY với khóa thực tế của bạn từ bảng điều khiển.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

Phản hồi bao gồm văn bản được tạo ra và thống kê sử dụng token. Nếu bạn nhận được phản hồi, tích hợp của bạn đang hoạt động đúng cách. Bạn có thể tiếp tục xây dựng các tương tác phức tạp hơn hoặc chuyển sang các client lập trình.

Tích hợp SDK Python

Sử dụng gói Python chính thức của OpenAI để tương tác với API của chúng tôi một cách mượt mà. Đặt base URL đến endpoint của chúng tôi và cung cấp khóa của bạn dưới dạng token API. Điều này cho phép bạn tận dụng các codebase hiện có mà không cần viết lại logic HTTP. Model ID là uncensored, kích hoạt mô hình ngôn ngữ lớn cụ thể của chúng tôi được tinh chỉnh cho đầu ra không giới hạn.

Copyfrom openai import OpenAI

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

Đoạn mã này minh họa một trao đổi tin nhắn cơ bản. Bạn có thể điều chỉnh mảng messages để bao gồm prompt hệ thống hoặc lịch sử hội thoại. SDK xử lý việc tuần tự hóa và phân tích lỗi cho bạn.

Tích hợp SDK Node

Tích hợp API vào các ứng dụng JavaScript hoặc TypeScript của bạn bằng SDK Node. Cấu hình base URL và API key giống như ví dụ Python. Cách tiếp cận này hoạt động tốt cho việc hiển thị phía máy chủ hoặc các dịch vụ vi mô phía sau. SDK trừu tượng hóa lớp mạng, cho phép bạn tập trung vào logic gợi ý.

Copyimport OpenAI from "openai";

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

Chạy mã này để xem mô hình phản hồi với đầu vào của bạn. Bạn có thể lặp lại nhanh chóng bằng cách thay đổi nội dung prompt. Cấu trúc phản hồi khớp với định dạng OpenAI tiêu chuẩn, đảm bảo tương thích với các công cụ khác trong stack của bạn.

Phản hồi luồng

Bật chế độ streaming để nhận các token ngay khi chúng được tạo, giúp giảm độ trễ cảm nhận. Điều này rất quan trọng cho các giao diện người dùng hiển thị văn bản theo thời gian thực. Đặt stream tham số thành true trong yêu cầu của bạn. API gửi một loạt Sự kiện gửi máy chủ (SSE) thay vì một đối tượng JSON đơn lẻ. Mỗi chunk chứa một phần delta của phản hồi.

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)

Nối các delta này ở phía máy khách để tái tạo lại thông báo đầy đủ. Phương pháp này mang lại cảm giác tức thì cho người dùng, ngay cả với các đầu ra dài. Chunk cuối cùng chứa tổng số lượng token đã sử dụng, cho phép bạn tính phí chính xác.

Giới hạn tốc độ và Ràng buộc

Hiểu các giới hạn kỹ thuật để ngăn ngừa lỗi yêu cầu trong môi trường sản xuất. Bạn được phép 300 yêu cầu mỗi phút mỗi khóa và có thể có 8 yêu cầu đồng thời. 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, API sẽ trả về mã trạng thái 429. Bạn nên triển khai cơ chế thử lại theo cấp số nhân trong máy khách của mình để xử lý các đỉnh này một cách nhẹ nhàng. Cửa sổ ngữ cảnh là 100.000 token tổng cộng, với đầu ra tối đa là 16.000 token mỗi yêu cầu. Lỗi và lời từ chối không tiêu thụ tín dụng, vì vậy bạn có thể thử lại một cách an toàn. Lỗi xác thực trả về 401 và thiếu tiền trả về 402.