配置模型接入

“模型接入”按接入点、鉴权凭证和模型组合三级维护:

接入点(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/completionshttps://api.example.com/v1/chat/completions
https://gateway.example.com/openai/v1/chat/completionshttps://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 Completionsopenai_chat_completions/v1/chat/completions
OpenAI Responsesopenai_responses/v1/responses
Anthropic Messagesanthropic_messages/v1/messages
Gemini Generate Contentgemini_generate_content/v1beta/models/{{vendor_model_id}}:generateContent
OpenAI Images Generationsopenai_images_generations/v1/images/generations

请求路径留空时,平台使用对应协议的默认路径。自定义路径必须是站内路径,建议以 / 开头;系统会为没有 / 的路径自动补全。

自定义路径不能是完整 URL,不能包含查询参数、片段或 ..。Gemini 路径中的 {{vendor_model_id}} 会在运行时替换为该组合的供应商模型 ID。

鉴权方式

页面鉴权方式实际发送方式
AuthorizationAuthorization: Bearer {API Key}
X-API-KeyX-API-Key: {API Key}
X-Goog-API-KeyX-Goog-API-Key: {API Key}
自定义 Header{自定义 Header 名}: {API Key}

选择“自定义 Header”时必须填写 Header 名。可选的“响应 ID Header”用于从响应中提取供应商请求追踪 ID,例如 x-request-id;它有助于双方排障,但不会改变请求鉴权。

配置完成检查

  • 接入点、凭证和模型组合均已启用。
  • Base URL 可从国内测试网络访问,且与请求路径不重复。
  • 供应商模型 ID 与真实请求的 model 值一致。
  • 每项已声明协议都能独立调用,路径和鉴权方式真实有效。
  • 资源来源、价格区域、折扣、RPM 和 TPM 已如实填写。

配置完成后,前往执行准入测试