配置模型接入
“模型接入”按接入点、鉴权凭证和模型组合三级维护:
接入点(API Base URL、所处位置)
└─ 鉴权凭证(API Key / Token)
└─ 模型组合(平台模型 + 供应商模型 ID + 协议)信息
平台只测试“已启用且配置完整”的模型组合,不会将所有接入点、密钥和模型自动交叉组合。
1. 创建接入点
| 字段 | 要求 | 示例 |
|---|---|---|
| 接入点名称 | 必填,用于识别环境或区域 | 国内生产站 |
| API Base URL | 必填,合法的 HTTP/HTTPS 地址 | https://api.example.com |
| 所属位置 | 必填,自由文本,最多 128 个字符 | 国内、美国、东南亚 |
| 关联控制台 | 可选,从基础信息中已维护的控制台选择 | 国内控制台 |
| 备注 / 启用状态 | 可选 / 仅启用的接入点可参与测试 | 主力节点 |
接入点名称和 Base URL 可以先留空保存草稿,但配置不完整的接入点不能参与测试。
正确填写 Base URL
Base URL 应为 API 根地址或稳定路径前缀,不应填写完整接口地址。
| 实际请求地址 | Base URL | 请求路径 |
|---|---|---|
https://api.example.com/v1/chat/completions | https://api.example.com | /v1/chat/completions |
https://gateway.example.com/openai/v1/chat/completions | https://gateway.example.com/openai/v1 | /chat/completions |
URL 不得包含用户信息、查询参数或片段。请检查 Base URL 和请求路径是否重复包含 /v1 或网关前缀。
2. 添加鉴权凭证
在接入点下新增测试凭证:
| 字段 | 说明 |
|---|---|
| 凭证名称 | 用途标识,例如“生产测试 Key A”。 |
| API Key | 实际请求使用的 Key 或 Token。 |
| 分组、备注 | 可选,可记录节点、用途或轮换信息。 |
| 启用状态 | 未启用的凭证不能组成可测试组合。 |
警告
凭证会在页面和测试结果中脱敏展示。不要将密钥粘贴到备注、审核说明、工单或聊天消息中。
3. 创建模型组合
模型组合的最小粒度为:
接入点 + 鉴权凭证 + 平台模型 ID + 供应商模型 ID同一平台模型使用不同 Endpoint、密钥、供应商模型 ID 或协议配置时,请分别创建组合,并分别测试和审核。
| 字段 | 要求 |
|---|---|
| 平台模型 ID | 从页面提供的可选模型中选择,不能自行填写未支持模型。 |
| 供应商模型 ID | 必填,必须是供应商 API 实际接受的模型名。 |
| 供应商接入协议与鉴权 | 至少声明一项;每项单独维护请求路径、鉴权方式和可选追踪 Header。 |
| OpenAI Chat 能力 | 仅声明 OpenAI Chat 时显示;按真实能力维护思考、缓存、输出 Token、工具调用、响应格式、停止词和采样等参数。 |
| 资源特征 | 可多选官转资源、逆向资源、自部署资源;请选择真实来源。 |
| 价格区域口径 | 必填;声明刊例价是否与原厂所在区域价格一致,不一致时如实填写价格说明。 |
| 折扣 | 必填,按百分比填写,范围为 0%–100%。 |
| RPM / TPM | 均必填,且必须为正整数。 |
| 启用状态 | 仅启用且完整的组合可发起测试。 |
折扣、RPM 和 TPM 只记录供应商声明信息,不替代供应商侧实际限流或计费控制。
4. 配置协议、路径与鉴权
支持的协议
| 页面协议 | 稳定标识 | 默认请求路径 |
|---|---|---|
| OpenAI Chat Completions | openai_chat_completions | /v1/chat/completions |
| OpenAI Responses | openai_responses | /v1/responses |
| Anthropic Messages | anthropic_messages | /v1/messages |
| Gemini Generate Content | gemini_generate_content | /v1beta/models/{{vendor_model_id}}:generateContent |
| OpenAI Images Generations | openai_images_generations | /v1/images/generations |
请求路径留空时,平台使用对应协议的默认路径。自定义路径必须是站内路径,建议以 / 开头;系统会为没有 / 的路径自动补全。
自定义路径不能是完整 URL,不能包含查询参数、片段或 ..。Gemini 路径中的 {{vendor_model_id}} 会在运行时替换为该组合的供应商模型 ID。
鉴权方式
| 页面鉴权方式 | 实际发送方式 |
|---|---|
| Authorization | Authorization: Bearer {API Key} |
| X-API-Key | X-API-Key: {API Key} |
| X-Goog-API-Key | X-Goog-API-Key: {API Key} |
| 自定义 Header | {自定义 Header 名}: {API Key} |
选择“自定义 Header”时必须填写 Header 名。可选的“响应 ID Header”用于从响应中提取供应商请求追踪 ID,例如 x-request-id;它有助于双方排障,但不会改变请求鉴权。
配置完成检查
- 接入点、凭证和模型组合均已启用。
- Base URL 可从国内测试网络访问,且与请求路径不重复。
- 供应商模型 ID 与真实请求的
model值一致。 - 每项已声明协议都能独立调用,路径和鉴权方式真实有效。
- 资源来源、价格区域、折扣、RPM 和 TPM 已如实填写。
配置完成后,前往执行准入测试。