开发指南
多协议 API 接入:OpenAI、Anthropic 与 Gemini 地址配置
说明九维 AI 原生协议的基础地址、用户密钥、模型权限与验证方法,避免重复路径和错误协议导致调用失败。
# 多协议 API 接入:选对地址、密钥与模型
九维 AI 支持多种原生协议。客户端使用本站创建的用户 API Key;上游供应商由管理员配置,用户无需保存供应商密钥。
供应商接入分工#
文本渠道使用 FunCloud;图片、视频、音频、音乐等生成使用 APIVERSE。国内文本供应商雪松正在等待 API 文档与地址,尚未完成接入。渠道和模型有配置或价格不代表已可调用,以账户授权及实际接入状态为准。
先确认模型权限#
从账户“模型中心”复制精确模型名称。国内模型默认开放;海外模型需要管理员明确分配。供应商文档中出现一个模型,不代表本站账户已获授权或供应商账号已开通。
按协议选择地址#
| 协议 | 本站地址 | 请求路径 |
|---|---|---|
| OpenAI 兼容 Chat | https://9weisc.cn/v1 | /chat/completions |
| OpenAI Responses | https://9weisc.cn/v1 | /responses |
| Anthropic Messages | https://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 和其原生内容块。选择相应的工具适配器,让客户端构造正确协议。
工具调用、缓存参数、流式返回与多模态素材应遵循所选模型的原生契约。本文不承诺任意供应商都支持跨协议转换,也不代表某个模型已经获得调用额度。
怎么验证#
- 确认账户有可用余额,并复制实际已授权的模型名称。
- 先在 Playground 发起一次简短文本请求。
- 再配置外部工具,检查协议、基础地址与用户密钥。
- 查看用量记录和扣费,确认真实返回结果。
渠道鉴权测试只验证账户接口。媒体模型的渠道可达不代表已成功生成成品;真实生成可能产生费用。
常见错误#
- 401:检查用户密钥是否有效,是否把供应商密钥填错位置。
- 403:检查模型是否被分配给当前账户。
- 模型未开通或无 Quota:需管理员核对供应商资源;模型有价格不代表账号能调用。
- 路径不匹配:检查客户端是否自动追加路径,以及请求体是否属于所选原生协议。
- 超时:先查询请求状态和用量,避免重复生成与重复扣费。
继续阅读:API Key 配置、兼容工具、故障排查。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。