跳转到主要内容
GET
列出 Devin Desktop 模型与定价

概览

返回调用方账户可用的模型、该账户实际支付的价格、您的团队当前是否允许使用各个模型,以及团队已保存的模型允许列表。请将其作为模型定价的程序化 source of truth,不要直接从模型页面复制价格;也可将其作为 Update Model Allowlist API 对应的读取接口。 价格取决于调用方的套餐和计费模式,因此不同团队查询同一模型可能得到不同的价格。
此端点处于 alpha 阶段 (v2alpha) ,响应结构可能会发生变化。

身份验证

在 Authorization 标头中传入 API 密钥:
使用 Devin 服务用户 API 密钥 (cog_...) 。该服务用户的角色必须包含 Use Devin Desktop 权限,且该账户需已开启 Devin Desktop 访问权限。

Request

string
不设置时,将列出你的套餐和计费模式允许的所有模型,忽略团队级限制。每个模型的 allowed 字段表示团队的限制当前是否允许使用该模型。设置为 allowlist 时,仅列出团队的模型允许列表、组织控制和组限制所允许的模型,使返回的列表与用户在 Devin Desktop 模型选择器中看到的内容一致。
string
先前响应中的 ETag。如果响应自那时起未发生变化,则返回不带响应体的 304 Not Modified。

请求示例

仅返回你的用户可选择的模型:

响应

响应中包含 ETag 标头,只要未经过滤的响应中有任何内容发生变化,该值就会随之改变,包括:可用模型、模型的名称和价格、模型的 allowed 标志,以及允许列表字段。请将其作为 If-Match 传给 Update Model Allowlist API;无论 filter 取何值,该值都相同。
object[]
调用方可使用的模型。已禁用的模型不会包含在内。
string[]
您的团队允许列表中的模型 UID (按存储原样返回) 。若团队仅按标签允许模型,则此项为空。
string[]
您的团队允许列表中的模型标签 (按存储原样返回) ,包括 provider-anthropic 等提供商标签。只要模型的 UID 在列表中,或模型带有列表中的任一标签,该模型即被允许。

示例响应

以下模型和价格仅用于展示响应结构。请调用该端点获取你的实际价格。

错误响应

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