模型与 Provider

接口用途

查询当前 Genesis Key 可用的模型列表。响应中的 data[].id 可直接用于其他接口的 model 字段。

请求方式

GET

接口地址

$GENESIS_BASE_URL/models

身份认证

使用 Genesis API Key：Authorization: Bearer <API_KEY>。详见接口地址与身份认证。

查询当前 Key 可用的模型

curl "$GENESIS_BASE_URL/models" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

GET /models 不需要请求体。响应的 data[].id 可直接用于其他接口的 model 字段。仓库参考资料还记录了类型、能力标签、状态和定价等信息，但这些附加字段可能随部署变化；客户端应以 id 为稳定读取目标，对未知字段保持兼容。

列表反映的是当前 Key的可访问范围，而不是平台全部模型。如果目标模型没有出现，依次检查：

  1. 模型广场中该模型当前是否可用；

  2. Key 的允许模型范围是否包含它；

  3. Key 是否过期、禁用或达到额度；

  4. 目标接口是否属于该模型的能力范围。

选择模型

先按任务筛选能力，再比较模型详情中的上下文、输入类型、价格和可用状态。常见对应关系如下：

能力

调用入口

对话或视觉理解

/chat/completions、/responses 或 /messages

文本或多模态向量

/embeddings

文本或多模态精排

/rerank

具体模型清单变化较快，文档不维护静态 ID 表。生产应用若需要动态选型，应定期读取 /models，并为不可用模型设计受控的降级映射；不要仅根据 Provider 名称假设两个模型的参数和输出完全兼容。

Provider 边界

Genesis 负责统一入口、认证、模型访问策略、计量和日志。底层 Provider 仍可能影响支持参数、上下文限制、流式事件细节和错误信息。因此：

  • 只发送目标模型明确支持的可选参数；

  • 不依赖某个 Provider 私有字段，除非当前模型详情明确要求；

  • 切换模型或 Provider 后重新进行质量、延迟和成本评测；

  • 将实际 model、请求 ID、用量和延迟写入应用观测，但不要记录密钥或敏感提示词。

模型广场和调试操作见Genesis 指南，各接口的通用参数速查见参考 · 模型 API。