模型列表
OpenAI 兼容的 GET /v1/models。返回当前 API Key 可访问的全部模型。
GET
/v1/models此接口无请求体。返回结构与 OpenAI 原生 GET /v1/models 保持兼容， OpenAI SDK 的 client.models.list() 可以直接使用。Swarmix 会额外返回 provider、上游模型、官方文档和价格等扩展字段。
请求里的
model 使用 data[].id。Swarmix 内部会把它映射到data[].upstream_model 后再转发给厂商。Provider 模型的公开 ID 推荐使用 provider/upstream_model，例如 aliyun/qwen-max。当前模型列表按 Router 已加载的公开模型目录返回，不做模型能力矩阵判断。视觉、工具调用、 JSON 输出、上下文限制等细节以返回的
docs_url 和厂商官方文档为准。请求头
| Header | 必填 | 示例 | 说明 |
|---|---|---|---|
Authorization | 建议 | Bearer sk-swx-xxx | 生产接入建议携带 Swarmix API Key；当前模型目录接口主要用于 SDK 兼容和模型发现。 |
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
data[].id | string | 客户侧公开模型 ID。在 chat.completions 或 messages 的 model 字段里使用这个值。 |
data[].object | string | 固定为 model。 |
data[].owned_by | string | 兼容 OpenAI 字段，当前格式通常为 swarmix-{provider}。 |
data[].created | integer | 兼容 OpenAI 字段。部分上游不提供真实创建时间，平台会使用固定兼容值。 |
data[].provider | string | 当前模型默认关联的上游厂商，例如 aliyun / volc / tencent。 |
data[].upstream_model | string | 实际转发给上游 endpoint 的模型 ID。可能与公开 id 不同，用于屏蔽厂商模型名变化。 |
data[].docs_url | string | null | 厂商官方文档链接。多模态、工具调用、JSON 输出等能力限制以该文档为准。 |
data[].capability_policy | string | 当前为 provider_docs，表示平台透传 OpenAI-compatible 结构，细节以厂商文档为准。 |
data[]._swarmix_pricing | object | 平台价格扩展字段，包含输入/输出单价、币种和上下文窗口；只有当前目录中存在定价时返回。 |
实时定价
/v1/models 当前会在 _swarmix_pricing 中返回基础价格信息。 如果需要价格、厂商、官方文档、上下文窗口和免费额度等扩展字段，使用 GET /v1/models/pricing。 当前公开 pricing 接口不把 group_name 作为稳定返回字段。
生产代码建议缓存模型列表 5-30 分钟。模型列表变化频率较低，高频调用容易浪费请求配额。