Grok 用戶快速上手
在幾分鐘內將現有的 Grok API 整合遷移至我們的無審查 OpenAI 相容端點。本指南涵蓋 SDK 設定、串流輸出、函式呼叫,以及尋求無縫替換方案的開發者需注意的關鍵限制。
安裝 OpenAI SDK
我們的 API 遵循標準的 chat-completions schema,因此你可以重複使用官方的 Python、Node.js 及其他語言的 OpenAI SDK。請確保已安裝最新版本的客戶端程式庫。這種方式讓你能夠保留現有的應用程式邏輯,同時僅需更換 Base URL 和 API 金鑰。你不需要自訂的客戶端或複雜的轉送層。唯一的條件是你的程式碼支援標準的 OpenAI 相容參數,例如 model、messages 和 stream。
設定 Base URL 與金鑰
將你的 SDK 客戶端指向我們的 Base URL:https://api.uncensoredgrok.com/v1。將 model 參數設定為 uncensored 以存取我們的開放權重模型。在僅使用電子郵件和密碼註冊後,請從「取得 API 金鑰」頁面取得 API 金鑰。開始使用不需要信用卡。金鑰在註冊完成時立即顯示,且可隨時重新產生,屆時舊金鑰將失效。這項簡單的設定可確保你的請求正確路由至我們的 GPU 伺服器,沒有任何隱藏的模型路由或聚合層。
發送第一個完成請求
對 /v1/chat/completions 發出標準的 POST 請求。該模型接受文字輸入並回傳文字輸出。請注意,我們不提供 embeddings、圖像生成、音訊處理或微調端點。僅提供 chat-completions 端點。我們的模型經過調整,能夠在合法成人、虛構或具爭議性的主題上無審查地回答。然而,有一個硬性限制:包含未成年人性內容的請求會被封鎖。對於所有其他合法內容,模型會直接處理請求,不會經過中間過濾器。
啟用串流回應
在請求中將 stream 參數設定為 true 以啟用串流輸出。API 會回傳 Server-Sent Events (SSE),你可以逐 token 進行解析。這非常適合即時的使用者體驗。回應格式符合標準的 OpenAI 串流協定,因此你現有的串流解析器應可在不需修改的情況下運作。你可以處理隨請求到達的部分 token,以降低使用者的感知延遲。此功能在 chat-completions 端點上受支援,並可與 Python 和 Node.js SDK 無縫整合。
使用工具呼叫
完全支援函式呼叫與工具呼叫。你可以在 tools 參數中定義工具,並讓模型決定何時呼叫它們。回應包含工具呼叫,你可以在應用程式邏輯中執行這些呼叫,然後將結果回傳至對話中。這使得複雜的工作流程無需外部協調即可實現。模型會透明地處理工具定義與呼叫。請注意,我們不提供模型路由或多個模型選項;這個單一的無審查模型原生處理所有工具互動。
限制、錯誤與上下文視窗
我們的模型支援 100,000 token 的上下文視窗,包含提示詞與完成 token。請求主體大小限制為 8 MB。每個 API 金鑰每分鐘允許 300 次請求。如果收到 401 錯誤,表示你的金鑰無效或已過期。402 錯誤表示預付額度不足。429 錯誤表示你已超過速率限制。定價透明:每 1M 輸入 token 為 $0.15,每 1M 輸出 token 為 $0.50。額度永不過期。請檢查可用模型端點以確認模型 ID 為 uncensored。
cURL
curl https://api.uncensoredgrok.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.uncensoredgrok.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.uncensoredgrok.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);串流輸出
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)技術規格
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| Base URL | https://api.uncensoredgrok.com/v1 |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| 模型 ID | uncensored |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 請求大小 | 每次請求不超過 8 MB |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10%,滿 $200 送 15% |
| 價格 | 輸入 $0.15 / 百萬 tokens · 輸出 $0.50 / 百萬 tokens |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 儲值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整數金額 |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 登入 | Google 或電子郵件 + 密碼 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
錯誤代碼
錯誤以 JSON 回傳,type 欄位固定;失敗或被拒絕的請求不計費。
| 狀態碼 | 類型 | 含義 |
|---|---|---|
400 | bad_request | JSON 無效、訊息為空、參數錯誤或超出上下文視窗 |
401 | missing_key · invalid_key · key_revoked | 缺少金鑰、金鑰錯誤或已被新金鑰取代 |
402 | no_credit | 餘額不足——儲值後立即恢復 |
403 | content_blocked | 涉及未成年人的性內容——拒絕且不計費 |
404 | not_found | 未知端點 |
413 | request_too_large | 請求內容超過 8 MB |
429 | rate_limited · concurrency | 超過每分鐘 300 次或 8 個並行——稍後重試 |
503 | upstream_busy | 模型忙碌——幾秒後重試 |
問答
這是官方的 Grok API 嗎?
否。我們是獨立服務。我們不是 OpenAI、xAI 或任何其他供應商。我們的模型是一個開放權重模型,在我們自己的伺服器上運行,針對無審查回應進行調整。它相容於 Grok API 格式,但是一個獨立產品。
你會使用我的提示詞進行訓練嗎?
不會。傳送至我們 API 的提示詞不會用於訓練。我們專注於原始 API 實用性。你的資料隱私在不需要複雜企業協議的情況下即可獲得保障。
如果我額度用完會怎樣?
請求將回傳 402 錯誤,直到你為預付額度儲值為止。你可以透過加密貨幣(USDT 或 USDC)付款,最低金額為 $20。額度永不過期,因此你可以隨時暫停並以自己的節奏恢復使用。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改 Base URL。這就是整個設定過程。