Hướng dẫn nhanh cho người dùng Unhinged Grok

Xác thực và URL cơ sở

API của chúng tôi tương thích với OpenAI, nghĩa là bạn không cần thư viện mới. Bạn chỉ cần cập nhật hai giá trị trong cấu hình hiện có: base_url và api_key. Khóa API của bạn được tạo ngay khi đăng ký qua Google hoặc email. Hãy giữ khóa này an toàn; đây là thông tin xác thực duy nhất cần thiết.

Thay thế URL base OpenAI tiêu chuẩn bằng endpoint của chúng tôi. Thay đổi này định hướng tất cả các yêu cầu tiếp theo đến máy chủ mô hình không kiểm duyệt của chúng tôi. Không cần thay đổi mã khác cho việc tạo văn bản cơ bản.

Ví dụ cấu hình

• Base URL: https://api.unhingedgrok.com/v1
• Khóa API: Khóa duy nhất của bạn từ bảng điều khiển

Xác minh kết nối bằng cách liệt kê các mô hình có sẵn. Điều này xác nhận xác thực của bạn đang hoạt động đúng trước khi gửi các yêu cầu tạo nội dung.

Yêu cầu đầu tiên

Bắt đầu bằng cách gửi một yêu cầu hoàn thành văn bản đơn giản. Ví dụ này sử dụng curl để minh họa cấu trúc HTTP thô. Yêu cầu nhắm vào endpoint /v1/chat/completions với ID mô hình uncensored. Phản hồi trả về văn bản được tạo trong mảng choices.

Cách tiếp cận trực tiếp này hoạt động cho bất kỳ ngôn ngữ hoặc công cụ nào hỗ trợ định dạng HTTP OpenAI tiêu chuẩn. Bạn có thể kiểm tra ngay lập tức sau khi tạo khóa của mình.

Yêu cầu HTTP trực tiếp

Sao chépcurl https://api.unhingedgrok.com/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."}]
  }'

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI để tích hợp API của chúng tôi. Cài đặt gói qua pip. Khởi tạo client với khóa và base URL tùy chỉnh của bạn. Các phương thức SDK khác, chẳng hạn như chat.completions.create, hoạt động chính xác như tài liệu cho OpenAI.

Phương pháp này lý tưởng cho các dịch vụ backend, kịch bản xử lý dữ liệu hoặc quy trình tự động hóa. SDK xử lý tự động việc tuần tự hóa JSON và phân tích phản hồi.

Ví dụ mã Python

Sao chépfrom openai import OpenAI

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

Đối với môi trường JavaScript hoặc TypeScript, hãy sử dụng gói npm openai chính thức. Cấu hình client với cùng base URL và khóa. SDK Node hỗ trợ cả mẫu callback và dựa trên promise.

Cài đặt này cho phép bạn nhúng trực tiếp việc tạo văn bản không kiểm duyệt vào các ứng dụng web, hàm serverless hoặc công cụ tự động hóa dựa trên Node. Xử lý lỗi vẫn nhất quán với hành vi SDK OpenAI tiêu chuẩn.

Ví dụ mã Node.js

Sao chépimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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 truyền phát

Bật tạo token theo thời gian thực bằng cách đặt stream: true. API trả về luồng Sự kiện được gửi bởi máy chủ (SSE). Mỗi chunk chứa phản hồi một phần. Chunk cuối cùng bao gồm thống kê sử dụng token.

Truyền phát giảm độ trễ cảm nhận được cho người dùng cuối. Nó rất cần thiết cho các giao diện trò chuyện và ứng dụng tương tác. Xử lý từng chunk tăng dần để cập nhật giao diện người dùng ngay lập tức.

Ví dụ mã truyền phát

Sao chépstream = 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

Hiểu các ràng buộc hoạt động để tránh gián đoạn dịch vụ. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100,000 token, và nếu max_tokens không được đặt, phản hồi có thể chạy đến hết cửa sổ.

Giới hạn tốc độ cho phép 300 yêu cầu mỗi phút mỗi khóa. Yêu cầu đồng thời được giới hạn ở 8. Thân yêu cầu không được vượt quá 8 MB. Xử lý các mã lỗi HTTP tiêu chuẩn: 401 cho biết khóa không hợp lệ, 402 báo hiệu tín dụng không đủ và 429 biểu thị giới hạn tốc độ. Lỗi không tiêu tốn tín dụng.