ZeroFA API

列出模型

返回当前 Key 档位下可用的模型 id 列表(OpenAI list 结构),可直接使用 OpenAI SDK 的 client.models.list()。

GEThttps://zerofa.ai/v1/models

说明

返回已上架(listed)的模型 id。切换模型只需修改请求中的 model 字段。

完整能力、定价和分类筛选见 模型广场。实验或内部模型可能未上架,因此不会出现在列表中。

按 Key 档位过滤(重要)

列表会按照当前 Key 的档位过滤。每个模型在经济、标准和高级档位下分别配置,同一模型不一定支持所有档位。/v1/models 只返回当前 Key 档位下实际可用的模型。

例如,某模型只配置了标准和高级档,那么经济档 Key 无法看到或调用该模型。未指定档位的 Key 默认使用标准档。

要查看模型支持的档位及各档实价,请打开 模型广场

档位是什么

  • 经济:成本优先、价格最低,适合对延迟或质量不敏感的批量场景。
  • 标准(默认):平衡性能与成本,适合多数生产调用。
  • 高级:优先高质量、高可用的上游,价格更高。

档位在创建 API Key 时选定,一把 Key 固定一个档位;跨档调用需要创建多把 Key。各模型支持的档位及价格见 模型广场

请求与响应体

用下面的示例确认请求格式与返回结构。需要在线发起请求时,点击页面顶部“调试”拉起在线运行面板。

curl https://zerofa.ai/v1/models \
  -H "Authorization: Bearer sk-zerofa-xxx"
响应 · 200
{
  "object": "list",
  "data": [
    { "id": "claude-sonnet-4-6", "object": "model", "created": 1715961234, "owned_by": "fornai" },
    { "id": "gpt-5.4-mini", "object": "model", "created": 1715961234, "owned_by": "fornai" }
  ]
}