千问办公企业旗舰版开发者文档:查询可用档位。
认证方式见APP开发者文档 → 认证接入。
媒体类型:
创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。
前端切换语言时优先读取
- 模块:会话服务(session)
- 接口:GET
/api/openapi/app/v1/sessions/session-modes
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| Accept-Language | header | string | 否 | name、description 的展示语言。当前仅支持中文和英文:以 zh 开头时返回中文,其他值或省略时返回英文。 |
响应
| HTTP | 说明 |
|---|---|
| 200 | 请求成功 |
| default | 错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。 |
application/json。
响应200 ModeListResponse
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| items | array<ModeInfo> | 是 | — | 当前账户可用的运行档位,按请求解析,不是全局目录,不能跨账户复用。 |
响应200 ModeInfo
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| revision | integer | 否 | — | 上游目录版本;上游为 0 时省略,前端据此识别目录展示配置。 |
| icon | object | 否 | — | 原样保留图标对象:url、size 均为 string;未配置时省略。 |
| badges | array<object> | 否 | — | 原样保留标签数组:kind 为 string,key 为可选 string,labels 为多语言字典;未配置时省略,空数组仍返回 []。 |
| frontier | boolean | 否 | — | 是否属于前沿模型分组;沿用上游约定,为 false 时省略。 |
| cost_factor | number | 是 | — | 免费用户积分消耗倍率,原样返回上游值,包含 0;不是货币价格。 |
| cost_factor_paid | number | 是 | — | 付费用户积分消耗倍率,0 表示该档位不扣积分。 |
| default | boolean | 是 | — | 省略创建请求的 mode 时是否选用此档位。按请求解析;没有任何默认档位时必须显式指定 mode。 |
| description | string | 否 | — | 档位用途的简短说明,按 Accept-Language 本地化;可与 name 一起展示。该字段可省略。 |
| names | object<string, string> | 否 | — | 原始多语言名称字典,例如 zh、en;键和值原样保留,不受 Accept-Language 影响。旧版本或无翻译时可省略。 |
| descriptions | object<string, string> | 否 | — | 原始多语言说明字典;格式同 names,不受 Accept-Language 影响,无翻译时可省略。 |
| mode | string | 是 | — | 创建会话时应传入 mode 的值。 |
| name | string | 是 | — | 展示名称,按 Accept-Language 本地化;界面展示 name,请求接口使用 mode。 |
使用说明
创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。
前端切换语言时优先读取 names、descriptions 中对应语言的值。现有 name、description 字符串字段继续按 Accept-Language 返回,兼容已有调用方;对接旧版本时可回退使用这两个字段,并在切换语言后重新请求。创建会话仍使用 mode,不使用展示名称。