跳到正文
九维AI开放平台使用文档

开发指南

多协议 API 接入:OpenAI、Anthropic 与 Gemini 地址配置

说明九维 AI 原生协议的基础地址、用户密钥、模型权限与验证方法,避免重复路径和错误协议导致调用失败。

成都九维数创科技有限公司 · 文档团队更新于 约 6 分钟阅读
本页目录
  1. 供应商接入分工
  2. 先确认模型权限
  3. 按协议选择地址
  4. 密钥怎么填
  5. 原生协议不能混用
  6. 怎么验证
  7. 常见错误

# 多协议 API 接入:选对地址、密钥与模型

九维 AI 支持多种原生协议。客户端使用本站创建的用户 API Key;上游供应商由管理员配置,用户无需保存供应商密钥。

供应商接入分工#

文本渠道使用 FunCloud;图片、视频、音频、音乐等生成使用 APIVERSE。国内文本供应商雪松正在等待 API 文档与地址,尚未完成接入。渠道和模型有配置或价格不代表已可调用,以账户授权及实际接入状态为准。

先确认模型权限#

从账户“模型中心”复制精确模型名称。国内模型默认开放;海外模型需要管理员明确分配。供应商文档中出现一个模型,不代表本站账户已获授权或供应商账号已开通。

按协议选择地址#

协议本站地址请求路径
OpenAI 兼容 Chathttps://9weisc.cn/v1/chat/completions
OpenAI Responseshttps://9weisc.cn/v1/responses
Anthropic Messageshttps://9weisc.cn/v1/messages
Gemini 原生协议https://9weisc.cn/v1/gemini/v1beta/models/模型名称:generateContent

客户端会自行追加路径时,只填写基础地址。不要把完整请求地址再次追加到基础地址,也不要把供应商专用路径填进本站地址。

密钥怎么填#

在本站“API 密钥”创建用户密钥,再填到工具的 API Key 字段。API 请求可使用 Authorization: Bearer,原生 Anthropic 或 Gemini 客户端也可使用其对应的密钥请求头。

Playground 登录后即可使用,无需另填用户 API Key。上游密钥由管理员在“上游渠道”加密保存,不能粘贴到公开文档或聊天里。

原生协议不能混用#

Chat 使用 messages,Responses 使用 input,Gemini 使用 contents,Anthropic 使用 messages 和其原生内容块。选择相应的工具适配器,让客户端构造正确协议。

工具调用、缓存参数、流式返回与多模态素材应遵循所选模型的原生契约。本文不承诺任意供应商都支持跨协议转换,也不代表某个模型已经获得调用额度。

怎么验证#

  1. 确认账户有可用余额,并复制实际已授权的模型名称。
  2. 先在 Playground 发起一次简短文本请求。
  3. 再配置外部工具,检查协议、基础地址与用户密钥。
  4. 查看用量记录和扣费,确认真实返回结果。

渠道鉴权测试只验证账户接口。媒体模型的渠道可达不代表已成功生成成品;真实生成可能产生费用。

常见错误#

  • 401:检查用户密钥是否有效,是否把供应商密钥填错位置。
  • 403:检查模型是否被分配给当前账户。
  • 模型未开通或无 Quota:需管理员核对供应商资源;模型有价格不代表账号能调用。
  • 路径不匹配:检查客户端是否自动追加路径,以及请求体是否属于所选原生协议。
  • 超时:先查询请求状态和用量,避免重复生成与重复扣费。

继续阅读:API Key 配置、兼容工具、故障排查。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground