Skip to main content
PUT
更新 Devin Desktop 模型允许列表

概述

替换您的团队的模型允许列表,该设置与 Admin 在 Devin Desktop 组织控制项中管理的设置相同。请求体即完整的目标状态:其中的两个列表会覆盖已存储的列表。 为避免覆盖你尚未看到的变更,请求必须在 If-Match 中携带 List Models 响应返回的 ETag。如果在该响应之后,允许列表、可用模型或模型价格发生了变化,更新将被拒绝并返回 412,此时你需要重新列出模型。
此端点处于 alpha 阶段 (v2alpha) ,请求和响应的结构可能会有所变化。

身份验证

在 Authorization 标头中传入 API 密钥:
使用 Devin 服务用户 API 密钥 (cog_...) 。除了 List Models 所需的 Use Devin Desktop 权限外,服务用户的角色还必须具有 Windsurf admin 权限 (account.windsurf.admin) ,内置的 Account Admin 角色已包含此权限。缺少该权限的服务用户虽然可以列出模型,但调用此端点时会返回 403。

请求

string
必填
GET /api/v2alpha/models 响应中的 ETag 标头,用于反映当前状态。必填;不接受 *。
string[]
必填
用户可选择的模型 UID,例如 ["claude-sonnet-4-5"]。传入 [] 表示仅按标签允许模型。
string[]
必填
用户可选择的模型标签,包括 provider-anthropic、provider-openai 等提供商标签。传入 [] 表示仅允许所列的模型 UID。
这两个字段均为必填。包含未知字段的请求将被拒绝。

请求示例

响应

成功时,返回的响应与 List Models 相同,并已应用新的允许列表:包含每个模型及其 allowed 开关、已存储的 allowed_model_uids 和 allowed_model_tags,以及新的 ETag 标头。

错误响应

错误以 {"error": "<message>"} 格式返回。