4-4 AI 快速開始:5 分鐘接入統一 AI API

教學 · 2026-11-20 · 約 8 分鐘讀完

這篇教學帶你從零完成 4-4 AI 的接入:拿金鑰 → 設 Base URL → 跑通第一段串流輸出。全程使用 OpenAI 相容介面——你現有的任何支援自訂 Base URL 的程式碼、框架和工具(openai SDK、LangChain、Cursor 等)都不需要改程式邏輯,只改設定。

前置準備

  1. 造訪 www.4-4.vip 註冊帳戶並登入控制台;
  2. 在控制台儲值或使用卡密兌換額度;
  3. 進入「令牌」頁面,新建一個 API 金鑰(形如 sk-...),妥善保存——它只在建立時完整顯示一次。
安全提示:API 金鑰等於帳戶額度,不要提交到 Git 儲存庫或前端程式碼。建議用環境變數管理。

核心概念:Base URL 與金鑰

4-4 AI 提供與 OpenAI 完全相容的介面協議,你只需要記住幾個設定:

設定項值
Base URLhttps://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);

接入主流框架與工具

常見問題(FAQ)

401 Invalid API Key?

依次檢查:① 金鑰複製時是否帶入了空格或換行;② 控制台令牌列表中該金鑰是否被停用/刪除;③ 帳戶額度是否用盡;④ Authorization 標頭格式是否為 Bearer sk-...(注意 Bearer 後有空格)。

429 請求過於頻繁?

閘道對令牌有速率限制。降低並發、增加重試退避(建議指數退避 + 抖動),或在控制台提升令牌的速率上限。

串流輸出中途中斷?

長回覆建議開啟 SDK 的逾時重試;如果經過公司代理,確認代理沒有緩衝 SSE 串流(text/event-stream)。

支援哪些模型?

以控制台「模型」頁面的即時列表為準。4-4 AI 聚合 GLM、DeepSeek、Qwen 等主流模型,同一把金鑰、同一套介面即可切換。

相關文章

自建 one-api / new-api vs 託管 AI 閘道:成本、維運與安全對比 誠實的決策框架:從隱性維運成本、故障場景、安全責任、費用模型四個維度對比自建 one-api/new-api 與託管 AI 閘道。 Cursor / Claude Code / Cherry Studio 接入自訂 AI 閘道指南 手把手設定 Cursor、Claude Code、Cherry Studio 等主流 AI 工具接入 OpenAI 相容的自訂 API 閘道(含 4-4 AI),Base URL 與金鑰設定方法、常見報錯排查。
準備好接入了嗎?

一把密鑰統一接入 GLM、DeepSeek、Qwen 等主流模型,統一計費、用量可視化。

查看模型與定價 註冊體驗