跳转到主要内容
GET /v1/models 列出当前账户可用的已启用模型。创建或更新 Agent 时，可使用这里返回的 id 作为 model 值。

​
请求头

头部必选说明
Authorization是Bearer <PAT>

​
查询参数

该接口当前不支持查询参数。

​
示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/models" \
  -H "Authorization: Bearer $QODER_PAT"

​
示例响应

HTTP 200 OK 
{
  "data": [
    {
      "id": "ultimate",
      "type": "model",
      "display_name": "Ultimate",
      "source": "system",
      "is_enabled": true,
      "is_new": false,
      "price_factor": 1.6,
      "efforts": ["low", "medium", "high"],
      "default_effort": "medium"
    }
  ],
  "has_more": false
}

​
响应字段

字段类型说明
dataarray可用 Model 对象数组
has_moreboolean固定为 false；模型列表当前不分页
data 中每个模型对象包含：
字段类型说明
idstring模型标识，创建或更新 Agent 时传入 model 字段
typestring固定为 "model"
display_namestring面向用户展示的模型名称
sourcestring模型来源，通常为 system；账号专属模型为 user
is_enabledboolean模型是否启用且可用
is_newboolean是否标记为新模型
price_factornumber可选，相对价格倍率
effortsarray可选，支持的推理 effort 等级，如 none、low、medium、high、xhigh、max
default_effortstring可选，上游模型目录指定的默认 effort 等级

​
注意事项

  • 只返回已启用模型。
  • 响应不会包含内部路由、供应商、token 上限、密钥或 description 字段。
  • 模型目录会按当前认证用户和服务端配置的 scene 解析；默认 scene 为 assistant。

​
错误码

HTTPtype触发条件
401authentication_errorPAT 无效或过期
503api_error模型目录暂时不可用
完整错误信封说明详见 错误参考。

​
相关

定义 Agent

创建可复用、可版本化的 Agent 配置。