Skip to Content
控制台使用模型与渠道

模型与渠道

调用侧选择模型,平台侧组织渠道。先确认“要调用什么”,再判断“平台通过什么资源提供”,可以避免把模型错误和渠道问题混在一起。

普通调用方通常只需要准确的模型名称。 渠道或 Provider 更接近平台如何连接和调度能力来源;除非你在处理资源配置或排障,否则不应把渠道名直接当作请求中的模型名。

模型和渠道分别回答什么

概念它回答的问题调用侧最常见的动作
模型这次请求需要哪种能力在请求参数中填写准确模型名称
能力类型模型适合文本、图片或其他哪类任务选择匹配的接口和参数结构
渠道 / Provider平台从哪里获得或组织这项能力通常由平台配置,排障时用于确认资源状态
可用状态当前账号和环境能否实际调用通过控制台与最小请求共同验证

模型在页面中可见,不一定代表当前 Key、环境和接口组合已经验证成功;示例文档中出现某个名字,也不等于所有账号都开放。最终应以当前控制台和真实 API 响应为准。

接入前完成四项确认

从当前环境取得模型名称

在模型页面或模型列表接口中确认目标模型,并复制准确名称。不要根据记忆输入,也不要擅自修改大小写、前后缀或版本标识。

确认能力与接口匹配

文本、流式、图片或异步能力可能使用不同接口和参数。先确认模型支持的能力类型,再选择对应 API 文档。

使用目标 Key 发起最小请求

用实际准备上线的 Key 和 Base URL 验证一次请求。这样可以同时发现模型名、访问权限、额度与请求格式问题。

记录业务中的模型配置

把模型名称放在服务端配置中,并记录用途、环境和负责人。不要让同一个名称散落在多处代码里,后续切换或排障会更容易。

常见错误如何区分

现象更可能属于哪一层优先检查
提示模型不存在或不可用模型名称或账号可用范围拼写、版本标识、当前环境与模型列表
同一模型偶发失败执行或渠道状态错误码、发生时间、任务状态与平台公告
文本接口能用,图片接口失败能力与接口不匹配模型能力、请求路径和参数结构
更换 Key 后模型不可用凭证权限或单 Key 限制Key 状态、额度以及所属账号范围
控制台可见但代码仍失败调用配置Base URL、请求头、模型字段和实际响应

变更模型时不要一次改完所有变量

建议保持 Base URL、Key 和请求结构不变,只替换模型名称进行最小验证。确认成功后,再调整温度、输出长度、图片尺寸或业务提示词等参数。一次只改变一类变量,失败时更容易定位。

不要把渠道凭证或内部资源信息写入调用方代码。调用方应使用GGPU平台 API Key,并面向平台公开的模型名称接入。

上线前检查清单

  • 模型名称来自当前账号与环境的可用列表
  • 所选模型的能力与接口类型一致
  • 目标生产 Key 已通过最小请求验证
  • 业务配置中记录了模型用途与负责人
  • 模型切换具备可回退的配置方式
  • 异步模型已经接入任务状态查询

继续阅读