模型与渠道
调用侧选择模型,平台侧组织渠道。先确认“要调用什么”,再判断“平台通过什么资源提供”,可以避免把模型错误和渠道问题混在一起。
普通调用方通常只需要准确的模型名称。 渠道或 Provider 更接近平台如何连接和调度能力来源;除非你在处理资源配置或排障,否则不应把渠道名直接当作请求中的模型名。
模型和渠道分别回答什么
模型在页面中可见,不一定代表当前 Key、环境和接口组合已经验证成功;示例文档中出现某个名字,也不等于所有账号都开放。最终应以当前控制台和真实 API 响应为准。
接入前完成四项确认
从当前环境取得模型名称
在模型页面或模型列表接口中确认目标模型,并复制准确名称。不要根据记忆输入,也不要擅自修改大小写、前后缀或版本标识。
确认能力与接口匹配
文本、流式、图片或异步能力可能使用不同接口和参数。先确认模型支持的能力类型,再选择对应 API 文档。
使用目标 Key 发起最小请求
用实际准备上线的 Key 和 Base URL 验证一次请求。这样可以同时发现模型名、访问权限、额度与请求格式问题。
记录业务中的模型配置
把模型名称放在服务端配置中,并记录用途、环境和负责人。不要让同一个名称散落在多处代码里,后续切换或排障会更容易。
常见错误如何区分
变更模型时不要一次改完所有变量
建议保持 Base URL、Key 和请求结构不变,只替换模型名称进行最小验证。确认成功后,再调整温度、输出长度、图片尺寸或业务提示词等参数。一次只改变一类变量,失败时更容易定位。
不要把渠道凭证或内部资源信息写入调用方代码。调用方应使用GGPU平台 API Key,并面向平台公开的模型名称接入。
上线前检查清单
- 模型名称来自当前账号与环境的可用列表
- 所选模型的能力与接口类型一致
- 目标生产 Key 已通过最小请求验证
- 业务配置中记录了模型用途与负责人
- 模型切换具备可回退的配置方式
- 异步模型已经接入任务状态查询