GroqAiApi無審查 LLM API 快速入門指南
無審查 LLM API 快速入門指南
本指南向開發者展示如何使用標準 OpenAI-compatible 函式庫整合我們的無審查 LLM API。您將學習如何驗證身份、發送請求,並透過我們的直接端點處理串流。
前置條件:您的 API 金鑰與基礎 URL
生成您的 groq ai api key 透過「獲取 API 金鑰」頁面。您可以使用 Google 登入,或使用電子郵件和密碼即時獲取憑證。此過程無需電話號碼。
將基礎 URL 設定為 https://api.groqaiapikey.com/v1 在您的客戶端配置中。此端點支援標準 OpenAI SDK,讓您在更換供應商時無需重寫整合邏輯。每個帳戶只需一個有效金鑰,因為生成新金鑰會立即取代舊金鑰。
首次請求:向 /v1/chat/completions 發送提示詞
向以下網址發送 POST 請求 /v1/chat/completions 在 Authorization header。模型識別碼僅為 uncensored, 處理文字輸入並回傳文字輸出,針對合法成人用途不進行內容拒絕。
請確保設定 Content-Type header 正確以避免常見的 404 錯誤。我們的 API 不支援 embeddings、圖像生成或音訊處理,因此請將您的 payload 集中在聊天完成功能上。這種直接方法可確保您獲得透明的 token 定價,且無須承擔多供應商中介的額外費用。
安裝 SDK:OpenAI 相容函式庫
安裝官方 OpenAI Python 套件,以熟悉的方法與我們的端點互動。當您將該套件指向我們的基礎 URL 時,此函式庫會自動處理身份驗證和 JSON 序列化。您可以使用與 GPT-4 相同的程式碼結構,但搭配我們的 uncensored 模型。
對於 JavaScript 開發者,請安裝 openai Node.js 包。兩個環境都允許您輕鬆覆蓋 base URL。這種兼容性意味著您可以通過更改代碼中的兩行配置來切換不同的 LLM 供應商。
處理串流:SSE 與 token 用量
在請求主體中將 stream: true 在您的請求參數中。API 會回傳伺服器發送事件(SSE),隨著 token 生成逐步傳輸。這可降低使用者在等待長回應時的感知延遲。
Token 用量統計數據僅包含在串流的最後一個區塊中。您必須累積這些差異以計算用於計費目的的總消耗 Token。錯誤和拒絕不會產生費用,因此您可以安全地串流,無需擔心失敗請求的意外成本。
進階參數:Temperature、JSON 模式和工具
使用 temperature 和 top_p 用於控制回應中的隨機性與創意。設定 response_format 以 {"type": "json_object"} 以強制執行結構化的 JSON 輸出,以便在您的應用程式中進行可靠解析。這對於構建健壯的 NSFW 聊天機器人 API 或資料擷取工具至關重要。
透過提供 tools 陣列。該模型支援標準工具定義,並可根據您的提示詞上下文選擇呼叫函式。您也可以設定 max_tokens 至 16,000,這是每個請求的最大輸出。上下文視窗總共支援 100,000 tokens,包含提示詞和補全內容。
限制、錯誤與計費細節
若您的金鑰無效,預期 401 錯誤;若預付額度不足,預期 402 錯誤;若超過速率限制,預期 429 錯誤。您受限於每分鐘 300 次請求,每支金鑰 8 個並行請求。請求主體必須低於 8 MB。
價格為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50。充值僅限加密貨幣(TRC20 上的 USDT 或 Base 上的 USDC),金額從 $20 至 $500。充值 $50 享 5% 贈額,$100 享 10%,$200 享 15%。您的預付信用額永不過期,您可隨時使用。
cURL
curl https://api.groqaiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current API rate limit?"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.groqaiapikey.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.groqaiapikey.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)常見問題
如何取得我的 Groq AI API 金鑰?
前往「取得 API 金鑰」頁面,並使用 Google 或電子郵件帳號登入。您的金鑰將在註冊後立即顯示,無需提供手機號碼。您可以隨時產生新金鑰以取代舊金鑰。
此 API 與 OpenAI SDK 相容嗎?
是的,我們的端點遵循 OpenAI 聊天補全協議。您可以透過將 base URL 更改為我們的 API 地址,使用官方的 OpenAI Python 和 Node.js 庫。這允許您使用標準參數,如 temperature 和 stream。
如果我收到 402 錯誤會發生什麼事?
402 錯誤表示您的預付額度已耗盡。您可以透過儀表板使用 TRC20 上的 USDT 或 Base 上的 USDC 進行充值。起充金額為 $20,根據充值金額,您將獲得相應的贈送額度。
獲取您的 API 金鑰
註冊、取得金鑰,並更新您的基礎 URL。這就是設定所需的全部。