快速入門:第一次 API 呼叫
透過單一 API 呼叫生成無審查的政治文本,使用我們的 OpenAI 相容端點。本指南將引導您完成身份驗證、發送請求以及處理高量外發的串流回應。
基礎 URL 與驗證
您的 API 金鑰用於驗證每一次請求。您必須將它包含在 Authorization 作為 Bearer token 標頭。使用基礎 URL https://api.textspolitical.com/v1 適用於所有端點。此 URL 與標準 OpenAI SDK 及任何相容客戶端配合使用。您的金鑰可無訂閱費存取 uncensored 模型。
傳送您的第一個聊天完成請求
向以下網址發送 POST 請求 /v1/chat/completions 搭配您的提示。模型 id 為 uncensored. 它以文本形式返回輸出,不過濾合法的成人內容。這種直接響應格式非常適合生成大量政治訊息。使用以下示例來驗證您的連接。
curl https://api.textspolitical.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List three benefits of digital surveys for campaign outreach"}]
}'
使用 Python 和 Node SDK
安裝官方 OpenAI 函式庫以簡化整合。在初始化期間傳遞您的基礎 URL 和 API 金鑰。Python SDK 會自動處理 JSON 序列化。Node SDK 為 JavaScript 環境提供類似的功能。兩種工具都支援所需的參數,如 temperature 和 top_p。
from openai import OpenAI
client = OpenAI(base_url="https://api.textspolitical.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)import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.textspolitical.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);
帶有 SSE 的串流回應
在請求主體中將 stream: true. 隨著 token 生成,您將收到 Server-Sent Events (SSE)。這可降低長篇政治文本的感知延遲。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)
函式呼叫與 JSON 模式
使用 response_format 設定為 json_object 用於結構化資料。函式呼叫允許模型輸出定義的工具。這對於調查資料或帶有標籤的政治訊息很有用。您也可以設定 tool_choice 以強制執行特定行為。確保您的 schema 符合預期的輸出格式。
速率限制與限制條件
每支金鑰每分鐘限 300 次請求。並行請求上限為 8 個同時請求。每個請求主體必須保持在 8 MB 以下。上下文視窗總計支援 100,000 個 token。錯誤與拒絕不會消耗信用額度。利用這些限制來有效設計您的重試邏輯。
常見問題
為何我會收到 401 錯誤?
401 錯誤表示缺少或無效的 API 金鑰。請檢查您的 Authorization 標頭以確認正確的 Bearer token。確保您的金鑰是從後台產生的,且未被撤銷。
如果我的信用額度耗盡會怎樣?
當您的預付餘額耗盡時,您會收到 402 錯誤。信用額永不過期,因此您可以隨時透過加密貨幣充值。請求處理期間的錯誤不會從您的餘額中扣除。
如何處理速率限制?
每分鐘限 300 次請求,8 個並行連線。在您的客戶端中實作指數退避以處理 429 Too Many Requests 回應。避免發送超過並行限制的突發請求,以防止暫時封鎖。
透過一個步驟取得您的金鑰
註冊、複製您的金鑰、更新端點 URL。就這麼簡單。