Skip to main content

查询可用档位

千问办公企业旗舰版开发者文档:查询可用档位。

认证方式见APP开发者文档 → 认证接入。
  • 模块:会话服务(session)
  • 接口:GET/api/openapi/app/v1/sessions/session-modes

请求参数

参数位置类型必填说明
Accept-Languageheaderstring否name、description 的展示语言。当前仅支持中文和英文:以 zh 开头时返回中文,其他值或省略时返回英文。

响应

HTTP说明
200请求成功
default错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。
媒体类型:application/json。

响应200 ModeListResponse

字段类型必填约束契约说明
itemsarray<ModeInfo>是—当前账户可用的运行档位,按请求解析,不是全局目录,不能跨账户复用。

响应200 ModeInfo

字段类型必填约束契约说明
revisioninteger否—上游目录版本;上游为 0 时省略,前端据此识别目录展示配置。
iconobject否—原样保留图标对象:url、size 均为 string;未配置时省略。
badgesarray<object>否—原样保留标签数组:kind 为 string,key 为可选 string,labels 为多语言字典;未配置时省略,空数组仍返回 []。
frontierboolean否—是否属于前沿模型分组;沿用上游约定,为 false 时省略。
cost_factornumber是—免费用户积分消耗倍率,原样返回上游值,包含 0;不是货币价格。
cost_factor_paidnumber是—付费用户积分消耗倍率,0 表示该档位不扣积分。
defaultboolean是—省略创建请求的 mode 时是否选用此档位。按请求解析;没有任何默认档位时必须显式指定 mode。
descriptionstring否—档位用途的简短说明,按 Accept-Language 本地化;可与 name 一起展示。该字段可省略。
namesobject<string, string>否—原始多语言名称字典,例如 zh、en;键和值原样保留,不受 Accept-Language 影响。旧版本或无翻译时可省略。
descriptionsobject<string, string>否—原始多语言说明字典;格式同 names,不受 Accept-Language 影响,无翻译时可省略。
modestring是—创建会话时应传入 mode 的值。
namestring是—展示名称,按 Accept-Language 本地化;界面展示 name,请求接口使用 mode。

使用说明

创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。 前端切换语言时优先读取 names、descriptions 中对应语言的值。现有 name、description 字符串字段继续按 Accept-Language 返回,兼容已有调用方;对接旧版本时可回退使用这两个字段,并在切换语言后重新请求。创建会话仍使用 mode,不使用展示名称。
{"items":[{"mode":"pro","name":"专业","description":"适合复杂任务","default":true,"cost_factor":0.25,"cost_factor_paid":0,"revision":1,"icon":{"url":"https://example.com/icon.svg","size":"sm"},"badges":[],"frontier":true,"names":{"zh":"专业","en":"Pro"},"descriptions":{"zh":"适合复杂任务","en":"For complex tasks"}}]}