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 的完整能力。