列出模型

返回当前 API Key 可以写进 model 的全部名称：Key 所属工作空间已开通、且安全围栏模型策略允许这个 Key 调用的模型，外加已启用的虚拟模型（@vmodel/<名称>）和 lyrouter/auto。响应是 OpenAI 的模型列表格式，适合客户端填充模型选择器，或在启动时检查配置的模型是否可用。这个接口由网关直接应答，不调用上游、不计费，也不写入日志列表。

鉴权

在请求头中携带 API Key：

Authorization: Bearer <API Key>

Bearer 区分大小写。也可以改用 x-api-key: <API Key>，两者同时存在时只读 Authorization。API Key 在工作空间的 API 密钥 页面创建，列表按这个 Key 所属的工作空间和适用的模型策略生成。完整说明见接入地址与鉴权。

请求头

GET 请求没有请求体，不需要 Content-Type。

查询参数

无。列表不分页，一次返回全部条目；请求中带的查询参数会被忽略。

请求示例

curl https://api.lyrouter.com/v1/models \
  -H "Authorization: Bearer $LYROUTER_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LYROUTER_API_KEY"],
    base_url="https://api.lyrouter.com/v1",
)

for model in client.models.list():
    print(model.id)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LYROUTER_API_KEY,
  baseURL: "https://api.lyrouter.com/v1",
});

for await (const model of client.models.list()) {
  console.log(model.id);
}

响应

成功时返回 Content-Type: application/json 的模型列表；出错时返回 error 对象。下面的 401 是请求没有带 API Key，503 是网关暂时读不到工作空间的模型配置。

{
  "object": "list",
  "data": [
    {
      "id": "deepseek/deepseek-v4-flash",
      "object": "model",
      "created": 1791964800,
      "owned_by": "workspace",
      "display_name": "DeepSeek V4 Flash",
      "context_length": 131072,
      "max_output_tokens": 8192,
      "api_types": ["chat_completions", "responses"],
      "input_modalities": ["text"],
      "output_modalities": ["text"],
      "supported_params": ["temperature", "top_p", "max_tokens", "tools", "tool_choice", "response_format", "stream"]
    },
    {
      "id": "google/gemini-3-pro-image",
      "object": "model",
      "created": 1791964800,
      "owned_by": "workspace",
      "display_name": "Gemini 3 Pro Image",
      "api_types": ["images"],
      "input_modalities": ["text", "image"],
      "output_modalities": ["image"]
    },
    {
      "id": "lyrouter/auto",
      "object": "model",
      "created": 1791964800,
      "owned_by": "workspace"
    },
    {
      "id": "@vmodel/support-bot",
      "object": "model",
      "created": 1791964800,
      "owned_by": "workspace"
    }
  ]
}

{
  "error": {
    "message": "missing credentials",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "Workspace model projection is unavailable",
    "type": "service_unavailable",
    "code": "workspace_model_projection_unavailable"
  }
}

条目顺序固定：先是具体模型，按模型 ID 的字母顺序排列；然后是 lyrouter/auto；最后是虚拟模型，按名称排列。

• display_name 及其后的字段只出现在具体模型上，并且只在模型目录有这项信息时才返回；字段缺失或为空数组（如 "api_types": []）都表示「没有声明」，不是「不支持」。
• lyrouter/auto 和虚拟模型只有 id、object、created、owned_by 四个字段，它们实际调用的模型由路由时决定。
• 响应始终是 OpenAI 格式，没有 Anthropic Models 接口的 has_more、first_id 等字段；使用 Anthropic SDK 的应用请直接发 HTTP 请求读取 data[].id。

列表包含哪些名称

与模型广场的关系

两者的范围相同，都是当前工作空间已开通的模型，区别在于展示对象：

模型广场中某个模型可用、列表中却没有它时，通常是安全围栏的模型策略限制了这个 Key，请当前账号管理员查看模型授权。公开的模型广场展示的是平台全部模型，与某个工作空间可调用的范围不同。

常见用法

填充客户端的模型选择器

用 display_name 展示、id 提交。只列对话模型时，保留 api_types 包含 chat_completions（使用 Responses 的客户端看 responses）的条目，没有 api_types 或 api_types 为空数组的条目和 lyrouter/auto、虚拟模型一起保留：

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["LYROUTER_API_KEY"], base_url="https://api.lyrouter.com/v1")

def is_chat(model):
    extra = model.model_extra or {}
    api_types = extra.get("api_types")
    return not api_types or "chat_completions" in api_types

options = [
    {"value": m.id, "label": (m.model_extra or {}).get("display_name") or m.id}
    for m in client.models.list()
    if is_chat(m)
]

display_name、api_types 等不是 OpenAI 的标准字段，OpenAI Python SDK 把它们放在 model_extra 中；Node.js SDK 直接作为对象属性读取。

按 api_types 筛选向量模型、重排模型的命令见创建向量和文档重排。

启动时检查配置的模型

应用启动时请求一次列表，确认配置文件里的模型 ID 在 data[].id 中；不在时提示「模型未开通或无权调用」，比等到第一次调用才收到 403 更容易排查。列表可以缓存几分钟，不必每次调用前都请求。

网关行为

• 由网关直接应答：网关按工作空间的配置生成列表，不调用上游服务商、不计费；模型发现请求不写入日志列表。
• 列表不代表一定调得通：网关生成列表时不检查服务商凭证当前是否可用，也不检查余额、预算和配额。列出的模型仍可能因凭证失效返回 503，或因余额不足返回 402，见模型不可用。
• 虚拟模型和 Auto 在调用时才检查：它们实际选中的模型被模型策略禁止时，调用返回 403 Request blocked by guardrail policy。
• 接口能力要另行判断：列表包含对话、向量、图像等各类模型。只给对话界面用时，按 api_types 或 output_modalities 筛选，见上文「常见用法」。
• 配置变化几秒后生效：在模型广场开通或停用模型、启用或停用虚拟模型、修改模型策略后，几秒内反映到列表中。

常见错误

错误响应为 {"error":{"message":"...","type":"...","code":"..."}}，code 只有部分错误才有。

• 用了 GET 以外的方法，或路径拼错（如 /v1/models/ 末尾多了 /）时返回 404，响应体是 {"error_msg":"404 Route Not Found"}，外层没有 error。
• 完整错误码见错误码与请求标识。

常见问题

列表里只有 lyrouter/auto，没有任何模型，怎么办？

答： 工作空间还没有开通任何模型，或者安全围栏的模型策略禁止了这个 Key 调用全部模型。在工作空间的 模型广场 确认「专属可用模型」不为空，再请当前账号管理员检查模型策略，见如何选择模型和模型授权。

同一个模型由多个服务商提供，为什么列表里只有一条？

答： 模型 ID 与服务商无关，一个模型只有一个 ID。调用时网关按通道选择与路由策略选择服务商，实际命中的服务商在请求日志的「服务商」中查看。

列表里的 id 能直接用在图像、视频接口上吗？

答： 具体模型的 id 可以，前提是 api_types 或 output_modalities 表明它支持该接口。lyrouter/auto 和 @vmodel/<名称> 用在图像、视频接口上返回 403 Model is not available in the model plaza：lyrouter/auto 只适合 Chat Completions、Anthropic Messages 和 Responses；虚拟模型除这三个接口外，也可以用于创建向量和文档重排，前提是它的模型列表全部是对应的向量或重排模型。