发现模型与能力
GET /v1/models
列出本服务已知的全部模型,包括尚未下载或加载的。按 supported_endpoints 筛出你要用的接口,读 default_for 判断默认值,发送内容前先看 execution_location。对齐模型会列出 /v1/audio/alignments:EdgeSpeak/Lattice-2 是默认档,覆盖目录里全部语言、混合语言文本与 und;EdgeSpeak/Lattice-1 只覆盖中文、英文和德文,需要显式指定才使用。
响应
200当前模型清单。示例只截取了一条,真实清单与它不同。objectstringdataobject[]idstring模型的规范 ID,请求里原样使用。objectstringcreatedintegerowned_bystringsupported_endpointsstring[]该模型能服务的路径,例如 /v1/chat/completions 或 /v1/audio/alignments。featuresstring[]能力标记,例如 reasoning、vision 或 tool_calling。execution_locationstringlocal 在服务所在机器上执行;配置为 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。{
"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 时按它退避。