4-4 AI 快速開始:5 分鐘接入統一 AI API
這篇教學帶你從零完成 4-4 AI 的接入:拿金鑰 → 設 Base URL → 跑通第一段串流輸出。全程使用 OpenAI 相容介面——你現有的任何支援自訂 Base URL 的程式碼、框架和工具(openai SDK、LangChain、Cursor 等)都不需要改程式邏輯,只改設定。
前置準備
- 造訪 www.4-4.vip 註冊帳戶並登入控制台;
- 在控制台儲值或使用卡密兌換額度;
- 進入「令牌」頁面,新建一個 API 金鑰(形如
sk-...),妥善保存——它只在建立時完整顯示一次。
安全提示:API 金鑰等於帳戶額度,不要提交到 Git 儲存庫或前端程式碼。建議用環境變數管理。
核心概念:Base URL 與金鑰
4-4 AI 提供與 OpenAI 完全相容的介面協議,你只需要記住幾個設定:
| 設定項 | 值 |
|---|---|
| Base URL | https://www.4-4.vip/v1 |
| API Key | 控制台令牌頁面建立的 sk-... 金鑰 |
| model 參數 | 按需填寫模型名,如 deepseek-chat、glm-4 等(以控制台模型列表為準) |
切換模型 = 只改 model 參數;切換供應商 = 只改 Base URL。這就是統一閘道的核心價值:業務程式碼與模型供應商解耦。
方式一:cURL(驗證連通性最快)
curl https://www.4-4.vip/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $44AI_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "用一句話介紹你自己"}
]
}'
看到回傳的 JSON 中包含 choices[0].message.content,說明整條鏈路已通。
方式二:Python(openai 官方 SDK)
pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["44AI_API_KEY"], # 你的 4-4 AI 金鑰
base_url="https://www.4-4.vip/v1" # 關鍵:指向 4-4 AI 閘道
)
# 一般呼叫
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "寫一個 Python 快排"}]
)
print(resp.choices[0].message.content)
# 串流輸出(streaming)
stream = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "講個冷笑話"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta
if delta and delta.content:
print(delta.content, end="", flush=True)
方式三:Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.N44_API_KEY,
baseURL: "https://www.4-4.vip/v1",
});
const completion = await client.chat.completions.create({
model: "deepseek-chat",
messages: [{ role: "user", content: "用 TypeScript 寫一個防抖函式" }],
});
console.log(completion.choices[0].message.content);
接入主流框架與工具
- LangChain / LlamaIndex:使用其 OpenAI 相容組件,把
base_url/openai_api_base設為上面的地址即可; - Cursor / Claude Code / Cherry Studio 等 AI 工具:在「自訂 API / OpenAI 相容」設定中填入 Base URL 與金鑰,詳見專門的工具接入指南;
- 自研程式:任何 HTTP 客戶端按 OpenAI 協議直接呼叫,無需額外 SDK。
常見問題(FAQ)
401 Invalid API Key?
依次檢查:① 金鑰複製時是否帶入了空格或換行;② 控制台令牌列表中該金鑰是否被停用/刪除;③ 帳戶額度是否用盡;④ Authorization 標頭格式是否為 Bearer sk-...(注意 Bearer 後有空格)。
429 請求過於頻繁?
閘道對令牌有速率限制。降低並發、增加重試退避(建議指數退避 + 抖動),或在控制台提升令牌的速率上限。
串流輸出中途中斷?
長回覆建議開啟 SDK 的逾時重試;如果經過公司代理,確認代理沒有緩衝 SSE 串流(text/event-stream)。
支援哪些模型?
以控制台「模型」頁面的即時列表為準。4-4 AI 聚合 GLM、DeepSeek、Qwen 等主流模型,同一把金鑰、同一套介面即可切換。
下一步閱讀:如果你的團隊正在「自建 one-api 還是買託管閘道」之間糾結,推薦看這篇決策框架:《自建 one-api / new-api vs 託管 AI 閘道》。或回到官網首頁了解 4-4 AI 的完整能力。