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 网关:成本、运维与安全对比 隐性运维成本清单、故障场景对比、决策框架——什么阶段该自建,什么阶段该用托管网关。 Cursor / Claude Code / Cherry Studio 接入自定义 AI 网关指南 主流 AI 编程与对话工具的自定义 Base URL 配置方法,附常见报错排查。
准备好接入了吗?

一把密钥统一接入 GLM、DeepSeek、Qwen 等主流模型,统一计费、用量可视化。

查看模型与定价 注册体验