基礎 URL 與驗證
我們的 API 遵循 OpenAI Chat Completions 標準。要與服務互動,你必須將你的用戶端指向 https://api.grokapikey.com/v1,並在 Authorization 標頭中包含你的唯一 API 金鑰。你可以在使用電子郵件和密碼註冊後立即產生此金鑰。金鑰在建立時僅顯示一次,因此請妥善儲存。如果你遺失了金鑰,可以從你的控制台產生新的金鑰,這會立即使舊金鑰失效。試用帳戶無需綁定信用卡。
您的首次請求
首先,發送一個簡單的文本提示詞以驗證連線。使用標準 chat/completions 端點,並指定模型識別碼 uncensored。以下範例展示了一個基本的 curl 指令來測試連線。這可以確認你的驗證正確且服務正在回應。然後你可以根據你的應用程式邏輯調整此結構。
執行此指令前,請將 YOUR_API_KEY 替換為您的實際金鑰。
curl https://api.grokapikey.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 SDK 整合
如果您正在開發 Python 應用程式,請使用官方的 openai 函式庫。將用戶端設定為使用我們的基礎 URL 和您的 API 金鑰。這使您能利用熟悉的 Python 慣用法來存取無審查模型。用戶端會自動處理序列化與串流輸出。請確保您的環境已安裝最新版本的函式庫,以獲得與我們端點的最佳相容性。
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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 SDK 整合
對於 JavaScript 或 TypeScript 專案,Node.js OpenAI SDK 可直接使用。在你的設定物件中設定 apiKey 和 baseURL 屬性。這可確保所有後續請求都通過我們的基礎設施路由。你可以使用標準的 async/await 模式來處理回應。此方法非常適合需要直接 API 存取且無需透過 OpenAI 代理的伺服器端應用程式或邊緣函式。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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);
串流回應
對於受益於即時 token 產生的應用程式,請在請求主體中設定 stream: true 以啟用串流輸出。API 會傳回伺服器發送事件 (SSE) 串流的部分回應。這可降低使用者的感知延遲,並允許立即顯示產生的文字。每個區塊包含回應的差異。在你的用戶端程式碼中處理這些事件以逐步更新 UI。串流輸出會正常消耗 token,且不會影響計費。
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)
限制、錯誤與上下文
每個 API 金鑰的速率限制為每分鐘 300 次請求,且請求主體大小上限為 8 MB。如果超過速率限制,API 將返回 429 狀態碼;請等待幾秒後重試。401 錯誤表示金鑰無效或已被撤銷,而 402 錯誤表示您的預付額度已耗盡。該模型支援 100,000 個 token 的上下文視窗,適用於輸入和輸出總和。請確保您的提示詞在此限制內,以避免截斷。內容篩選器保持最少,僅對涉及未成年人的性內容有硬性封鎖。