Yêu cầu đầu tiên trong vòng 5 phút
Tích hợp API không kiểm duyệt của chúng tôi vào quy trình AI NSFW của bạn bằng cách cập nhật ba giá trị cấu hình trong máy khách tương thích OpenAI hiện có của bạn. Hướng dẫn nhanh này bao gồm xác thực, tạo văn bản và truyền phát mà không cần thêm thư viện.
URL cơ sở và Xác thực
API của chúng tôi mô phỏng giao diện OpenAI v1, cho phép bạn thay đổi endpoint mà không cần thay đổi logic ứng dụng. Sử dụng https://api.groknsfw.top/v1 làm URL cơ sở của bạn. Xác thực yêu cầu khóa API hợp lệ được truyền trong tiêu đề Authorization dưới dạng token Bearer. Bạn có thể tạo khóa này ngay lập tức thông qua đăng nhập Google hoặc email trên bảng điều khiển. Mỗi tài khoản hỗ trợ một khóa hoạt động tại một thời điểm; việc phát hành khóa mới sẽ vô hiệu hóa khóa trước đó ngay lập tức. Mô hình khóa đơn này giúp đơn giản hóa kiểm soát truy cập cho hầu hết các môi trường phát triển và QA.
Yêu cầu đầu tiên
Gửi yêu cầu hoàn thành trò chuyện tiêu chuẩn để kiểm tra kết nối. Định danh mô hình là uncensored, xử lý việc từ chối nội dung khác với các mô hình tiêu chuẩn. Dưới đây là ví dụ cơ bản sử dụng công cụ dòng lệnh curl để xác minh khóa và URL cơ sở của bạn là chính xác.
curl https://api.groknsfw.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."}]
}'
Nếu bạn nhận được phản hồi JSON với choices và usage, việc tích hợp của bạn đã hoạt động. Hãy kiểm tra đối tượng usage để xem mức tiêu thụ token nhằm theo dõi hóa đơn chính xác.
Tích hợp SDK Python
Sử dụng gói Python openai chính thức để tương tác với endpoint của chúng tôi. Đặt các thuộc tính base_url và api_key trước khi thực hiện các lệnh gọi. Cách tiếp cận này hoạt động với bất kỳ thư viện nào hỗ trợ lược đồ OpenAI, giúp di chuyển từ các nhà cung cấp khác trở nên dễ dàng.
from openai import OpenAI
client = OpenAI(base_url="https://api.groknsfw.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)
Đoạn mã này minh họa một yêu cầu đồng bộ. Đối với việc tạo nội dung NSFW có thông lượng cao, hãy cân nhắc sử dụng máy khách không đồng bộ để xử lý nhiều yêu cầu đồng thời mà không làm chặn luồng chính của bạn.
Cài đặt SDK Node.js
Đối với các ứng dụng JavaScript hoặc TypeScript, hãy định cấu hình SDK OpenAI để trỏ đến URL cơ sở của chúng tôi. Điều này đảm bảo mã máy khách hiện có của bạn hoạt động mà không cần sửa đổi. Hệ sinh thái Node.js được hưởng lợi từ khả năng tương thích này, cho phép tạo nguyên mẫu nhanh chóng các giao diện trò chuyện NSFW.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groknsfw.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);
Đảm bảo bạn đang sử dụng phiên bản SDK mới nhất hỗ trợ URL cơ sở tùy chỉnh. Đối tượng cấu hình phải bao gồm nghiêm ngặt các thuộc tính apiKey và baseURL để tránh sai lệch endpoint.
Phản hồi truyền phát (SSE)
Bật tạo token theo thời gian thực bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Sự kiện được gửi bởi máy chủ (SSE), phân phối token khi chúng được tạo. Điều này giảm độ trễ cảm nhận đối với người dùng cuối trong các ứng dụng trò chuyện.
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)
Phân tích các sự kiện SSE để trích xuất nội dung delta. Chunk cuối cùng trong luồng chứa thống kê usage tổng cộng, mà bạn nên sử dụng để đối chiếu hóa đơn chính xác. Truyền phát không ảnh hưởng đến việc đếm token hoặc giá.
Giới hạn, Lỗi và Ngữ cảnh
Các yêu cầu của bạn bị giới hạn 300 mỗi phút và 8 yêu cầu đồng thời mỗi khóa. Kích thước tối đa của thân yêu cầu là 8 MB, và cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token tổng cộng. Lỗi được trả về theo định dạng HTTP tiêu chuẩn: 401 cho khóa không hợp lệ, 402 cho tín dụng không đủ, và 429 cho giới hạn tốc độ. Lỗi tín dụng không mất phí, nhưng giới hạn tốc độ yêu cầu bạn giảm tốc độ yêu cầu. Đầu ra tối đa mỗi yêu cầu là 32.000 token; việc bỏ qua max_tokens sẽ mặc định là 2.048 token.
Thông số kỹ thuật
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 |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.groknsfw.top/v1 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID mô hình | uncensored |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Đầ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) |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 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 |
| 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 |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 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 |
| Kích thước yêu cầu | tối đa 8 MB |
| 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í |
| 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 |
| Giá | $0,25 cho 1 triệu token đầu vào · $1,00 cho 1 triệu token đầu ra |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $10 đến $500 |
| Đă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 |
Hỏi đáp
Đây có phải là API Grok chính thức không?
Không, chúng tôi là dịch vụ độc lập lưu trữ mô hình trọng số mở được tinh chỉnh cho phản hồi không kiểm duyệt. Chúng tôi sử dụng cùng giao thức API với OpenAI, nhưng mô hình của chúng tôi không phải là GPT-4, Grok hay mô hình của nhà cung cấp khác. Hãy kiểm tra tài liệu của nhà cung cấp để biết chi tiết mô hình cụ thể.
Làm thế nào để tôi lấy thêm khóa API?
Mỗi tài khoản chỉ giới hạn một khóa API hoạt động tại một thời điểm. Tạo khóa mới trên bảng điều khiển sẽ vô hiệu hóa ngay lập tức khóa trước đó. Thiết kế này giúp đơn giản hóa quản lý truy cập cho nhà phát triển cá nhân và nhóm nhỏ.
Bạn có hỗ trợ gọi hàm không?
Có, API hỗ trợ gọi hàm tiêu chuẩn thông qua các tham số <code>tools</code> và <code>tool_choice</code>. Bạn cũng có thể bắt buộc đầu ra JSON bằng cách sử dụng <code>response_format: { "type": "json_object" }</code> để tạo dữ liệu có cấu trúc.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ quá trình thiết lập.