快速入門:整合我們的平價 AI API
使用標準 OpenAI 相容格式,幾分鐘內即可開始使用我們的無審查 LLM API 生成文字。本指南涵蓋身份驗證、基本請求、串流輸出和函式呼叫,且無供應商鎖定。
身份驗證與基礎 URL
要使用我們的 cheap ai api,你需要從儀表板取得 API 金鑰。所有請求都指向基礎 URL https://api.cheapaiapis.com/v1。這可確保與現有 OpenAI SDK 和客戶端的相容性。
將您的金鑰包含在 Authorization 標頭中作為 Bearer token。如果金鑰無效,您將收到 401 錯誤。如果您的預付額度已耗盡,您會收到 402 錯誤。在取得 API 金鑰處註冊,即可立即獲得您的 token。
我們無審查 LLM 的模型識別符僅為 "uncensored"。單一模型即可處理所有文字生成任務,無需路由開銷。
curl https://api.cheapaiapis.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."}]
}'
標準聊天補全
聊天補全 API 端點接受帶有 messages 陣列的 POST 請求。每則訊息都需要 role(system、user 或 assistant)和 content。此結構允許多輪對話或單次提示詞。
我們的基礎設施高效處理文字輸入並返回文字輸出。該模型經過調整以具備靈活性,處理多樣化主題而不會對合法成人內容進行不必要的拒絕。請求主體限制為 8 MB。
使用 Python SDK 快速整合。客戶端會自動處理序列化和 HTTP 請求。
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapaiapis.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)
串流回應(SSE)
對於需要即時回饋的應用程式,請透過設定 stream: true 啟用串流。API 會返回包含部分 token 區塊的伺服器發送事件(SSE)。
此方法可降低最終使用者的感知延遲。您應在收到每個區塊時進行處理,並組裝最終回應。串流輸出適用於所有配置為 SSE 的標準 OpenAI 相容客戶端。
請注意每個金鑰每分鐘 300 次請求的限制。串流輸出不會繞過速率限制;它僅改變數據交付方式。
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 實作允許您在請求中定義工具。模型會返回符合您架構的結構化 JSON,從而啟用程式化動作。
定義具有名稱、描述和參數架構的函式。API 會回應工具呼叫,您執行後將結果傳回模型以獲得最終答案。這可將邏輯與生成過程分開。
確保您的函式定義為有效的 JSON。架構結構中的錯誤可能導致模型返回格式錯誤的工具呼叫。
模型列表與 Token
使用 GET /v1/models 取得可用模型。你將看到「無審查」模型及其特定功能被列出。
該模型支援 100,000 token 的上下文視窗,結合提示詞和補全 token。這允許進行大量的文件處理或長對話,而無需立即截斷。
定價透明:每 1M 輸入 token 為 $0.25,每 1M 輸出 token 為 $1.00。額度永不過期,因此您只需為使用的部分付費。
限制、錯誤與上下文
透過儀表板監控您的使用情況。API 對每個金鑰實施每分鐘 300 次請求的限制。超出此限制將導致 429 錯誤。如需重置狀態,請重新產生您的金鑰。
常見錯誤包括 401(金鑰無效)、402(資金不足)和 429(速率限制)。請在您的客戶端程式碼中妥善處理這些錯誤。
上下文視窗限制適用於發送和接收的總 token。請規劃您的提示詞結構,以有效利用 100k 限制。
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.cheapaiapis.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);問答
閱讀文件此 API 是否相容於 OpenAI SDK?
是,它使用標準的 OpenAI 相容聊天補全格式。您只需更新現有客戶端設定中的基礎 URL 和 API 金鑰即可。
如果額度用完會發生什麼事?
請求將返回 402 錯誤。您可以使用加密貨幣(USDT 或 USDC)儲值,最低 $10 起。額度永不過期,您可隨時加值。
該模型會拒絕內容嗎?
該模型對合法成人、虛構及爭議性主題無審查。它僅會封鎖涉及未成年人的性內容,這是硬性限制。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改基礎 URL。這就是整個設定。
https://api.cheapaiapis.com/v1
API 技術參數
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.cheapaiapis.com/v1 |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 模型 ID | uncensored |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 請求大小 | 每次請求不超過 8 MB |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 儲值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整數金額 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
| 登入 | 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 | 模型忙碌——幾秒後重試 |