通过 API 访问应用

在 FastGPT 中，发布渠道里的 API 入口展示当前登录成员可用的 APIKey。APIKey 是团队成员的开放接口调用凭证，不再按应用创建专属密钥。

调用当前应用的 chat/completions 接口时，推荐在请求体传入 appId。如果第三方应用只能配置 OpenAI SDK 风格的密钥，也可以使用 apiKey-appId 兼容格式。完整说明可以查看 OpenAPI 介绍。

对接自己的用户系统

版本要求：FastGPT 4.18.0 及以上。

APIKey 由接入方后端保管。后端完成用户认证后，可通过 customUid 传入自己的使用者 ID：

{
  "appId": "68ad85a7463006c963799a05",
  "customUid": "customer-42",
  "messages": [{ "role": "user", "content": "你好" }]
}

customUid 最长 1024 字符，原值传递给工作流的 userId，并记录为对话日志的使用者；未传、null 或空字符串时使用默认成员身份。它不改变 APIKey 的鉴权成员与权限。customUid 与代表团队成员调用的 authProxy 互斥，同时提供会返回参数错误。

对话日志默认展示使用者；可在列设置中开启默认隐藏的“鉴权者”。CSV 按所选列导出。此参数用于身份标记，接入方后端仍需管理用户认证和可访问的会话。

获取 APIKey

依次选择应用 ->「发布渠道」->「API」，然后点击「新建」创建密钥。

APIKey 代表当前登录成员的开放接口调用凭证。请妥善保管密钥；如需再次复制，可在 API 列表中点击复制按钮。

🍅

Tips: 安全起见，你可以设置一个额度或者过期时间，防止 key 被滥用。

替换三方应用的变量

OPENAI_API_BASE_URL: http://localhost:3000/api (改成自己部署的域名)
OPENAI_API_KEY = 上一步获取到的密钥（推荐在请求体传 appId；如第三方应用只能配置密钥，可填 apiKey-appId 兼容格式）

ChatGPT Next Web 示例：

ChatGPT Web 示例：

通过 API 访问应用

对接自己的用户系统

获取 APIKey

替换三方应用的变量

本页导航