Hướng dẫn nhanh for Grok Unrestricted users
Kết nối ứng dụng khách tương thích OpenAI hiện có của bạn với mô hình không kiểm duyệt của chúng tôi trong vài phút. Thay đổi base URL và khóa API, sau đó gửi yêu cầu đến các endpoint bạn đã quen thuộc.
Yêu cầu tiên quyết
Trước khi gửi yêu cầu, hãy đảm bảo bạn có một khóa API và một ứng dụng khách được cấu hình cho các endpoint tương thích OpenAI. Tạo tài khoản trên trang web của chúng tôi bằng cách Tiếp tục với Google hoặc email và mật khẩu. Khóa API của bạn sẽ hiển thị ngay lập tức và là thông tin xác thực duy nhất bạn cần. Không cần số điện thoại hoặc thẻ tín dụng cho thiết lập ban đầu. Bạn sẽ nhận được tín dụng dùng thử miễn phí $0,50 có giá trị trong 7 ngày để kiểm tra endpoint. Nhận tín dụng này chỉ với một cú nhấp chuột trên trang khóa API của bạn. Để sử dụng sản xuất, hãy nạp tiền bằng USDT (TRC20) hoặc USDC (Base). Dịch vụ hỗ trợ các quy trình văn bản đầu vào, văn bản đầu ra tiêu chuẩn với cửa sổ ngữ cảnh 100.000 token.
Xác thực
Bao gồm khóa API của bạn trong tiêu đề Authorization của mọi yêu cầu. Sử dụng lược đồ Bearer theo sau bởi chuỗi khóa của bạn. Điều này xác thực tài khoản của bạn với base URL api.grokunrestricted.com. Nếu khóa không hợp lệ hoặc bị thiếu, API sẽ trả về lỗi cho biết lỗi xác thực. Hãy đảm bảo khóa của bạn còn hiệu lực; việc tạo khóa mới sẽ thay thế khóa trước đó. Không cần thêm phạm vi hoặc quyền cho các hoàn thành trò chuyện tiêu chuẩn.
Chat Hoàn thành Endpoint
Gửi tin nhắn đến endpoint POST /v1/chat/completions. Chỉ định ID mô hình là uncensored. Thân yêu cầu nên bao gồm mảng messages với lịch sử hội thoại của bạn. API trả về phản hồi văn bản trong mảng choices. Endpoint này hỗ trợ các tham số tiêu chuẩn như temperature, top_p và stop. Các yêu cầu được tính phí dựa trên việc sử dụng token thực tế. Lỗi và từ chối không phát sinh chi phí.
Truyền phát Phản hồi
Sử dụng Sự kiện được gửi bởi máy chủ (SSE) để truyền phát. Đặtstream thành true trong yêu cầu của bạn. API trả về một luồng các chunk, mỗi chunk chứa văn bản một phần. Chunk cuối cùng bao gồm tổng mức sử dụng token cho yêu cầu. Phương pháp này giảm độ trễ cảm nhận được cho các phản hồi lớn. Sử dụng các SDK chính thức để tự động xử lý phân tích luồng. Truyền phát hoạt động với tất cả các tham số tiêu chuẩn.
Gọi hàm
Bật sử dụng công cụ bằng cách cung cấp mảng tools trong yêu cầu. Xác định chữ ký hàm với tên, mô tả và lược đồ tham số. Mô hình trả về các lệnh gọi công cụ trong phản hồi khi phù hợp. Bạn phải thực hiện công cụ ở phía của mình và truyền kết quả lại trong các tin nhắn tiếp theo. API không xác minh độ chính xác của đầu ra công cụ; bạn chịu trách nhiệm xử lý kết quả. Sử dụng tool_choice để kiểm soát cách mô hình chọn hàm.
Chế độ JSON
Buộc mô hình xuất ra JSON hợp lệ bằng cách đặt response_format thành {"type": "json_object"}. Điều này hữu ích cho việc trích xuất dữ liệu có cấu trúc hoặc tạo cấu hình. Mô hình sẽ cố gắng tuân thủ các quy tắc cú pháp JSON. Đảm bảo prompt của bạn mô tả rõ ràng cấu trúc dự kiến. Phản hồi JSON không hợp lệ vẫn có thể xảy ra nếu mô hình gặp khó khăn với các lược đồ phức tạp. Xác thực đầu ra ở phía ứng dụng khách của bạn trước khi phân tích cú pháp.
cURL
curl https://api.grokunrestricted.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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.grokunrestricted.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokunrestricted.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);Truyền phát
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)Thông số API
Toàn bộ giới hạn và tính năng thực tế của API ở một nơi — hãy kiểm tra trước khi nạp tiền.
| Mục | Giá trị |
|---|---|
| Định dạng | tương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa |
| ID mô hình | uncensored |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.grokunrestricted.com/v1 |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Gọi hàm | có — tools, tool_choice; phản hồi có tool_calls, kể cả khi streaming; kết quả gửi lại bằng role: tool |
| Đầu ra tối đa | tối đa phần còn lại của cửa sổ 100.000 token; max_tokens tùy chọn (không giới hạn riêng) |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Kích thước yêu cầu | tối đa 8 MB |
| Dùng thử miễn phí | $0,50 trong 7 ngày, không cần thẻ · Khóa dùng thử: 2 yêu cầu song song, 60 yêu cầu/phút; hạn mức đầy đủ (8 và 300) sau lần nạp đầu |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Thưởng | +5% từ $50, +10% từ $100, +15% từ $200 |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $20 đến $500 |
| Tính phí | tín dụng trả trước theo mức dùng thực tế; lỗi và từ chối miễn phí |
| Giá | $0,15 cho 1 triệu token đầu vào · $0,50 cho 1 triệu token đầu ra |
| Đăng nhập | Google hoặc email và mật khẩu |
| Khóa | mỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ |
| Nội dung | cho phép nội dung người lớn; từ chối nội dung tình dục liên quan đến trẻ vị thành niên |
Mã lỗi
Lỗi trả về dạng JSON với type cố định; yêu cầu lỗi hoặc bị từ chối không bị tính phí.
| Mã | Loại | Ý nghĩa |
|---|---|---|
400 | bad_request | JSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh |
401 | missing_key · invalid_key · key_revoked | thiếu khóa, sai khóa hoặc khóa đã bị thay |
402 | no_credit | hết tín dụng — nạp tiền là dùng tiếp ngay |
403 | content_blocked | nội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí |
404 | not_found | endpoint không tồn tại |
413 | request_too_large | nội dung lớn hơn 8 MB |
429 | rate_limited · concurrency | vượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại |
503 | upstream_busy | mô hình đang bận — thử lại sau vài giây |
Câu hỏi and answers
Tôi xử lý giới hạn tốc độ như thế nào?
API cho phép 300 yêu cầu mỗi phút trên mỗi khóa và 8 yêu cầu đồng thời. Nếu bạn vượt quá giới hạn này, API sẽ trả về lỗi. Bạn nên triển khai logic thử lại với độ trễ tăng dần trong ứng dụng của mình để xử lý quá tải tạm thời hiệu quả.
Điều gì xảy ra nếu tôi hết tín dụng?
Yêu cầu sẽ thất bại nếu số dư tài khoản của bạn không đủ. Lỗi miễn phí, vì vậy bạn sẽ không bị tính phí cho các yêu cầu thất bại do thiếu tiền. Nạp tiền vào tài khoản của bạn bằng tiền mã hóa để tiếp tục dịch vụ. Tín dụng không bao giờ hết hạn.
Cửa sổ ngữ cảnh có 100k token tổng cộng không?
Đúng vậy, cửa sổ ngữ cảnh là 100,000 token cho cả prompt và kết hợp hoàn thành. Không có giới hạn đầu ra riêng biệt. Nếu bạn không chỉ định max_tokens, phản hồi có thể chạy đến hết cửa sổ ngữ cảnh.
Bạn key is one form away
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.
Lấy khóa API