接入应用

通过 Genesis 控制台的 使用 页面，可以查看当前接口的接入信息并生成请求模板。本页说明如何在控制台完成准备和复制；认证 Header、请求参数和响应字段请以对应的开发者接口文档为准。

接入前准备

开始前请准备以下信息：

1. 在模型广场查看模型详情并复制模型 ID。

2. 创建个人访问令牌，或创建已授予 Genesis 权限的服务账号 API Key。具体操作请参阅管理 Genesis 访问凭据。

3. 阅读调用前准备，确认所选接口适用的凭据和认证 Header。

在使用页面复制模板

1. 在左侧导航中打开 使用。

2. 在 接入信息 中复制 Base URL。

3. 在 API 使用 区域选择要调用的接口和示例语言。

4. 在 输入示例、响应示例 和 参数说明 页签之间切换，确认模型与业务输入符合所选接口。

5. 复制页面生成的模板，替换其中的访问凭据、模型 ID 和业务输入后，再在本地运行。

页面模板用于快速开始，完整的接口定义请进入Genesis API。文本对话、图文对话、Embeddings、Rerank 和 Responses 分别有独立的开发者页面；使用 Messages 时，也应查看其对应接口页面中的认证和请求要求。

核对模板中的模型和响应

运行模板前，先通过查询可调用模型确认模型 ID 位于当前凭据的结果中，再替换模板中的模型值。模型目录会变化；模板中的固定名称或占位值需要按当前结果核对。

• 调用 Messages 时，选择能力标签包含 messages 的模型。

• 调用 Rerank 时，选择支持目标输入类型的重排序模型；包含图像等输入时，还需确认相应多模态能力。

响应示例 用于说明返回结构。调用是否成功，应以本地实际请求的状态、响应内容和业务结果为准。模板复制成功或样例中出现回复文本，均不能证明已经完成一次模型调用。

接入失败时先检查什么

现象	先检查
401 或认证失败	按调用前准备检查凭据类型、令牌状态和 Header。
模型不可用	确认请求中的模型 ID 与模型广场一致，并通过查看模型列表确认当前凭据是否可调用。
接口或参数不支持	确认模型支持所选接口；回到调试模型验证，再查看对应的开发者接口文档。
需要定位一次调用	打开查看运行情况中的 日志，按页面提供的条件筛选并查看记录。

最后更新于 2026 年 11 月 3 日