Router Provider 列表与 upsert 接口

# 列出 provider
curl -X GET "https://router.example.com/v1/router/providers" \
  -H "Authorization: Bearer <api-key>"

# upsert 一个 provider（仅管理员）
curl -X PUT "https://router.example.com/v1/router/providers" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "openai",
    "default_model": "gpt-4o",
    "models": [
      {"name": "gpt-4o", "backend_ref": "openai/gpt-4o"},
      {"name": "gpt-4o-mini", "backend_ref": "openai/gpt-4o-mini"}
    ]
  }'

{
  "items": [
    {
      "name": "openai",
      "default_model": "gpt-4o",
      "models": [
        {"name": "gpt-4o", "backend_ref": "openai/gpt-4o"},
        {"name": "gpt-4o-mini", "backend_ref": "openai/gpt-4o-mini"}
      ]
    },
    {
      "name": "anthropic",
      "default_model": "claude-3-5-sonnet-20241022",
      "models": [
        {"name": "claude-3-5-sonnet-20241022", "backend_ref": "anthropic/claude-3-5-sonnet"}
      ]
    }
  ]
}

# 列出 provider
curl -X GET "https://router.example.com/v1/router/providers" \
  -H "Authorization: Bearer <api-key>"

# upsert 一个 provider（仅管理员）
curl -X PUT "https://router.example.com/v1/router/providers" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "openai",
    "default_model": "gpt-4o",
    "models": [
      {"name": "gpt-4o", "backend_ref": "openai/gpt-4o"},
      {"name": "gpt-4o-mini", "backend_ref": "openai/gpt-4o-mini"}
    ]
  }'

{
  "items": [
    {
      "name": "openai",
      "default_model": "gpt-4o",
      "models": [
        {"name": "gpt-4o", "backend_ref": "openai/gpt-4o"},
        {"name": "gpt-4o-mini", "backend_ref": "openai/gpt-4o-mini"}
      ]
    },
    {
      "name": "anthropic",
      "default_model": "claude-3-5-sonnet-20241022",
      "models": [
        {"name": "claude-3-5-sonnet-20241022", "backend_ref": "anthropic/claude-3-5-sonnet"}
      ]
    }
  ]
}

使用 Provider 接口列出全部已配置的推理 provider，或创建并更新单个 provider 规格。GET 返回完整的 provider 集合。PUT 按标识符 upsert 一个 provider。只有管理员调用者可以修改 provider。当你需要轮换后端引用、新增模型，或在不替换整个 router 配置的情况下接入新的 provider 时，此接口非常有用。

接口

GET /v1/router/providers

PUT /v1/router/providers

认证

使用会话 Cookie 认证，或携带 Authorization: Bearer <api-key>。PUT 方法需要管理员角色。

GET 响应

array

已配置 provider 的列表。

Show items

string

唯一的 provider 标识符。

string

未指定模型时的回退模型。

array

此 provider 的模型定义。

Show items

string

模型名称。

string

后端端点或标识符。

PUT 请求体

string

required

唯一的 provider 标识符。

string

客户端未选择模型时的回退模型。

array

带后端引用的模型定义列表。

PUT 响应

string

被 upsert 的 provider 的标识符。

boolean

该 provider 是被更新（true）还是被创建（false）。

# 列出 provider
curl -X GET "https://router.example.com/v1/router/providers" \
  -H "Authorization: Bearer <api-key>"

# upsert 一个 provider（仅管理员）
curl -X PUT "https://router.example.com/v1/router/providers" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "openai",
    "default_model": "gpt-4o",
    "models": [
      {"name": "gpt-4o", "backend_ref": "openai/gpt-4o"},
      {"name": "gpt-4o-mini", "backend_ref": "openai/gpt-4o-mini"}
    ]
  }'

{
  "items": [
    {
      "name": "openai",
      "default_model": "gpt-4o",
      "models": [
        {"name": "gpt-4o", "backend_ref": "openai/gpt-4o"},
        {"name": "gpt-4o-mini", "backend_ref": "openai/gpt-4o-mini"}
      ]
    },
    {
      "name": "anthropic",
      "default_model": "claude-3-5-sonnet-20241022",
      "models": [
        {"name": "claude-3-5-sonnet-20241022", "backend_ref": "anthropic/claude-3-5-sonnet"}
      ]
    }
  ]
}

PIN API

ROUTER API

AGENT API

Router Provider 列表与 upsert 接口

接口

认证

GET 响应

PUT 请求体

PUT 响应

​接口

​认证

​GET 响应

​PUT 请求体

​PUT 响应

接口

认证

GET 响应

PUT 请求体

PUT 响应