開發人員整合指南

驗證與 Base URL 設定

在儀表板生成您的 API 金鑰。基礎 URL 為 HTTPS://api.apiaicheap.com/v1。以 bearer token 形式將您的金鑰傳入 Authorization 標頭。

• 點擊「取得 API 金鑰」並使用 Google 或電子郵件登入。
• 立即複製金鑰；它只會顯示一次。

此金鑰用於驗證所有對聊天完成端點的請求。

範例標頭

授權：Bearer YOUR_API_KEY

首次使用 cURL 的請求

發送基本的聊天補全以測試您的設定。使用 POST /v1/chat/completions 端點，模型為 "uncensored"。

此操作可確認您的餘額與延遲時間。

• 將 role 設為 "user"。
• 保持訊息簡單以便進行首次測試。

檢查響應中是否包含生成的文本字段。

• 尋找 "content" 值。

若收到 200 OK，表示您的整合運作正常。

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Python SDK 整合

使用官方的 OpenAI Python 函式庫以輕鬆整合。將其指向我們的 base URL 並設定您的 API 金鑰。

此方法自動處理重試和 JSON 解析。

• 透過 pip 安裝函式庫。
• 將 base_url 參數設定為我們的端點。

呼叫 chat.completions.create 方法。

將您的訊息列表作為參數傳遞。

• 包含模型名稱「uncensored」。

透過物件的屬性存取回應文本。

這種方法對於生產腳本來說乾淨且易讀。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiaicheap.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 設置

Node.js SDK 的運作方式與 Python 版本類似。使用您的金鑰與我們的基礎 URL 初始化客戶端。

這讓您可以使用熟悉的 async/await 模式。

• 匯入 OpenAI 套件。
• 在構造函數中配置 base URL。

使用您的訊息建立完成請求。

處理 Promise 以獲取結果。

• 從響應中提取消息內容。

記錄輸出以驗證模型是否正確回應。

此設定非常適合網頁伺服器與後端服務。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicheap.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 來啟用串流。API 會透過伺服器發送事件傳回產生的區塊。

這可降低聊天應用程式中使用者的感知延遲。

• 在有效載荷中設定 stream: true。
• 隨到隨處理每個數據塊。

合併這些片段以形成最終回應。

Token 用量詳情出現在最後一個數據塊中。

• 檢查最後一個區塊中的 "usage" 欄位。

此方法在長時間生成期間保持使用者介面的響應性。

Copystream = 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)

限制、錯誤與上下文視窗

您的帳戶每金鑰每分鐘限制為 300 次請求。上下文視窗支援提示和補合計 100,000 個 token。

錯誤透過標準 HTTP 狀態碼處理。

• 401 表示 API 金鑰無效或缺失。
• 402 表示您的預付額度已耗盡。
• 429 表示您已超過速率限制。

拒絕不消耗信用額度。錯誤也是免費的。

每個請求的最大輸出為 16,000 個 Token。如果需要較少輸出，請設定 max_tokens。

這種結構確保可預測的計費和效能。