发现模型与能力

GET /v1/models

列出本服务已知的全部模型,包括尚未下载或加载的。按 supported_endpoints 筛出你要用的接口,读 default_for 判断默认值,发送内容前先看 execution_location。对齐模型会列出 /v1/audio/alignments:EdgeSpeak/Lattice-2 是默认档,覆盖目录里全部语言、混合语言文本与 und;EdgeSpeak/Lattice-1 只覆盖中文、英文和德文,需要显式指定才使用。

指南与示例模型与服务全部接口

响应

200当前模型清单。示例只截取了一条,真实清单与它不同。
objectstringlist
dataobject[]
idstring模型的规范 ID,请求里原样使用。
objectstringmodel
createdinteger
owned_bystring
supported_endpointsstring[]该模型能服务的路径,例如 /v1/chat/completions 或 /v1/audio/alignments。
featuresstring[]能力标记,例如 reasoning、vision 或 tool_calling。
execution_locationstringlocal 在服务所在机器上执行;配置为 remote 的模型会收到发给它的请求。local | remote
default_forstring[]该模型作为默认值的路径。读这个字段,不要写死别名。
supported_languagesstring[]播报模型:/v1/audio/speech 的 language 可以传哪些语言,用规范码表示(FireRedTTS3 的方言写 zh-x-<name>)。列出语言的地区和文字变体(如 zh-TW)同样可用,auto 总是可用。
x_edgespeakobjectEdgeSpeak 扩展字段。播报模型的 speech_language.open_set 为 true 时,模型还接受 supported_languages 以外的 ISO 639 码,例如 k2-fsa/OmniVoice。
JSON
{
  "object": "list",
  "data": [
    {
      "id": "Qwen/Qwen3.5-4B",
      "object": "model",
      "created": 0,
      "owned_by": "EdgeSpeak",
      "supported_endpoints": [
        "/v1/chat/completions",
        "/v1/responses",
        "/v1/messages",
        "/v1/tokenize"
      ],
      "features": [
        "reasoning",
        "vision",
        "tool_calling"
      ],
      "execution_location": "local",
      "default_for": []
    }
  ]
}
401API Key 缺失或无效。
403Host 或 Origin 不被允许,或 License 被拒。按 error.code 区分这两种情况。
503所需的本地模型仍在准备(model_downloading),或服务正忙(service_busy)。带 Retry-After 时按它退避。