帮搬办AI Gateway 接入文档 - 大模型 API 调用说明

1. 平台说明

帮搬办AI Gateway 是一个大模型 API 聚合接入平台，适合把多个模型能力统一接入到同一个业务入口。这样做的好处是：你不需要分别维护多套模型接口，也不需要在不同项目里重复写不同供应方的接入代码。

适合场景

网站接入 AI 对话或生成能力
企业后台接入智能助手
自动化工作流与机器人调用
原型验证与多模型效果对比

接入思路

注册账号并登录平台
创建或获取 API 访问令牌
使用统一接口发起请求
根据业务需要选择模型

2. 获取访问令牌

注册并登录帮搬办AI Gateway。
进入平台后台，找到 API 令牌或令牌管理相关入口。
创建新的访问令牌，并妥善保存。
在服务端或安全配置环境中使用，不要直接暴露在公开前端页面。

建议把令牌存到环境变量里，比如 API_KEY，不要硬编码进仓库。

3. OpenAI 兼容调用方式

很多业务系统、SDK 和自动化工具都支持 OpenAI 兼容格式。对接时，通常你只需要替换 base_url 和 api_key，再按平台可用模型名发起请求即可。

POST /v1/chat/completions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "model": "你的模型名",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手"},
    {"role": "user", "content": "你好，帮我写一段产品介绍"}
  ]
}

4. Curl 调用示例

curl https://api.bangban.xin/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "请给我写一段商品文案"}
    ]
  }'

如果你的平台当前开放的模型名不同，请以后台显示为准，把 gpt-4o 替换成实际可用的模型标识。

5. Python 调用示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.bangban.xin/v1"
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "帮我生成一段客服欢迎语"}
    ]
)

print(resp.choices[0].message.content)

6. Node.js 调用示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.bangban.xin/v1"
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "帮我写一段品牌介绍" }
  ]
});

console.log(resp.choices[0].message.content);

7. 接入建议

先从一个最小场景开始，比如单个聊天接口或单个生成任务。
把 API Key 放服务端，不要直接明文暴露到网页端。
为不同业务准备不同令牌，便于统计与隔离。
模型名、限流和可用能力以平台后台显示为准。
上线前先验证异常处理、超时处理和重试策略。

8. 为什么文档页对搜索和转化都重要？

文档页不仅是给开发者看的说明书，也是搜索引擎判断这个平台“能不能接、怎么接、接入门槛高不高”的重要页面。很多用户会直接搜索“OpenAI 兼容接口怎么接”“大模型 API 文档”“AI Gateway 接入示例”，这些都属于高意图流量。

能承接“怎么接入”的问题型搜索
能承接“有没有示例”的开发型搜索
能把阅读者直接引导到注册、测试和正式接入
能与 FAQ、模型说明、价格页形成更完整的站内决策链路