模型 API
模型目录与能力选择
查询当前密钥可见模型，理解模型 ID、供应商协议、上下文与能力限制。
更新于
GET
/v1/modelsGET
/v1/models/{model}列出模型
GET /v1/models 返回当前账户、密钥与分组可见的模型目录。将返回的 id 原样用于请求，不要从模型营销名称推测 API ID。模型供应、价格和权限会变化，部署新应用或切换分组时应重新验证。
cURL
curl --fail-with-body https://api.token4ai.cloud/v1/models -H "Authorization: Bearer $TOKEN4AI_API_KEY"Response shape (illustrative)
{"object":"list","data":[{"id":"YOUR_MODEL_ID","object":"model","owned_by":"provider"}]}读取单个模型
GET /v1/models/{model} 查询具体模型。路径参数中的斜杠等特殊字符必须编码。模型不存在或不在当前授权目录中时，不要自动换成任意默认模型；应由应用明确选择可接受的替代方案。
先匹配能力，再比较价格
- 聊天与推理：确认协议、最大输出和上下文限制。
- 工具与结构化输出：先用最小 schema 验证目标模型；网关兼容不等于每个模型支持相同参数。
- 图像、音频、Embedding、Rerank：需要对应能力和已配置的供应路线。若当前分组没有可用模型，请联系支持。
- 价格：以控制台当前分组价目表和实际结算为准，模型目录不是价格承诺。