# 接入应用

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

## 接入前准备

开始前请准备以下信息：

1. 在[模型广场](models.md)查看模型详情并复制模型 ID。
2. 创建个人访问令牌，或创建已授予 Genesis 权限的服务账号 API Key。具体操作请参阅[管理 Genesis 访问凭据](api-keys.md)。
3. 阅读[身份认证](../../developer/api/genesis-model-api/getting-started/authentication.md)，确认所选接口适用的凭据和认证 Header。

## 在使用页面复制模板

1. 在左侧导航中打开 **使用**。
2. 在 **接入信息** 中复制 Base URL。
3. 在 **API 使用** 区域选择要调用的接口和示例语言。
4. 在 **输入示例**、**响应示例** 和 **参数说明** 页签之间切换，确认模型与业务输入符合所选接口。
5. 复制页面生成的模板，替换其中的访问凭据、模型 ID 和业务输入后，再在本地运行。

![Genesis 使用页面，包含接入信息、接口和语言选择，以及 API 使用示例。](images/api-usage.png)

页面模板用于快速开始，完整的接口定义请进入[Genesis 模型 API](../../developer/api/genesis-model-api/index.md)。文本对话、图文对话、Embeddings、Rerank 和 Responses 分别有独立的开发者页面；使用 Messages 时，也应查看其对应接口页面中的认证和请求要求。

## 接入失败时先检查什么

| 现象 | 先检查 |
| --- | --- |
| 401 或认证失败 | 按[身份认证](../../developer/api/genesis-model-api/getting-started/authentication.md)检查凭据类型、令牌状态和 Header。 |
| 模型不可用 | 确认请求中的模型 ID 与[模型广场](models.md)一致，并使用[获取可用模型](../../developer/api/genesis-model-api/getting-started/available-models.md)验证当前凭据的可调用范围。 |
| 接口或参数不支持 | 确认模型支持所选接口；回到[调试模型](debug.md)验证，再查看对应的开发者接口文档。 |
| 需要定位一次调用 | 打开[查看运行情况](observe.md)中的 **日志**，按页面提供的条件筛选并查看记录。 |