# 调试模型

调试页用于在控制台中验证模型、输入和调用形态。先选择任务类型和模型，再按页面填写输入并运行；运行后可查看输出、请求 JSON、原始响应以及页面显示的用量信息。

## 选择调试类型

在左侧导航中打开 **调试**。页面顶部按任务类型分组，当前可根据需要选择：

| 任务 | 调试页签 | 适用输入 |
| --- | --- | --- |
| 文本对话 | **对话（文本）** | 文本消息。可选择 Chat、Messages 或 Responses。 |
| 图文对话 | **对话（多模态）** | 文本提示词与图片 URL 或本地图片。可选择 Chat、Messages 或 Responses。 |
| 文本向量化 | **嵌入（文本）** | 每行一段文本。 |
| 图片向量化 | **嵌入（多模态）** | 图片 URL 或本地图片。 |
| 文本重排序 | **重排序（文本）** | 查询文本与候选文档列表。 |
| 图文重排序 | **重排序（多模态）** | 查询文本、候选文本，以及可选的候选图片。 |

页面显示为不可用的 OCR、文生图、文生视频、文转音或音转文页签，不表示这些能力已经可以通过当前调试页调用。请以可选择的页签和模型列表为准。

## 调试文本对话

1. 选择 **对话（文本）**，再选择 Chat、Messages 或 Responses。
2. 在左侧选择模型；可按需调整页面提供的温度、Top P、最大输出 Token、流式输出等配置。
3. 输入问题或消息，点击 **发送**、**运行 Messages** 或 **运行 Responses**。
4. 查看模型输出；Messages 和 Responses 页面还会显示请求 JSON 与原始响应。

![文本 Chat 调试页，包含模型选择、生成参数、流式输出开关和对话输入框。](images/debug-text-chat.png)

Chat 适合验证连续对话和流式输出。使用 **清空对话** 可重新开始一次会话。

![文本 Messages 调试页，包含模型、系统提示词、输入、运行按钮、输出文本、请求 JSON 和原始响应区域。](images/debug-text-messages.png)

Messages 适合验证 Anthropic Messages 调用形态。系统提示词、流式输出和最大输出 Token 是否可用，以当前页面显示为准。

![文本 Responses 调试页，包含模型、Store、Previous Response ID、Instructions、Tools JSON 和响应区域。](images/debug-text-responses.png)

Responses 页可按需填写 Instructions、Previous Response ID 或 Tools JSON。只有在所选模型及路由支持时，才使用 Store、延续上下文或工具相关选项；出现不支持提示时，切换模型或调用形态后重新验证。

## 调试图文对话

1. 选择 **对话（多模态）**，再选择 Chat、Messages 或 Responses。
2. 选择支持视觉输入的模型。
3. 填写图片 URL，或点击 **选择图片** 上传本地图片；再输入希望模型回答的问题。
4. 运行后查看输出和原始响应。

![多模态 Chat 调试页，包含模型、图片 URL、本地图片上传、系统提示词和提问输入框。](images/debug-multimodal-chat.png)

![多模态 Messages 调试页，包含图文输入、模型输出和原始响应区域。](images/debug-multimodal-messages.png)

![多模态 Responses 调试页，包含图文输入、Store、Previous Response ID、Instructions 和 Tools JSON。](images/debug-multimodal-responses.png)

本地图片会在浏览器中转换为本次调试请求所需的数据形式；不要上传包含敏感信息的图片。不同模型支持的图片输入和调用形态不同，提交前确认已选择支持视觉输入的模型。

## 调试 Embeddings

### 文本 Embeddings

1. 选择 **嵌入（文本）**。
2. 选择文本 Embedding 模型；按需开启或关闭 **归一化**。
3. 在输入框中每行填写一段文本，点击 **生成向量并对比**。
4. 查看生成结果及页面提供的相似度对比。

![文本 Embeddings 调试页，包含模型选择、归一化开关、逐行文本输入和生成向量按钮。](images/debug-text-embeddings.png)

### 多模态 Embeddings

1. 选择 **嵌入（多模态）**。
2. 选择多模态 Embedding 模型。
3. 输入图片 URL，或上传本地图片。
4. 点击 **生成图片向量**，查看结果。

![多模态 Embeddings 调试页，包含图片 URL、本地图片上传和图片预览。](images/debug-multimodal-embeddings.png)

调试页用于直观比较结果。应用接入时，输入结构、向量格式和返回字段请参阅[文本与多模态 Embeddings](../../developer/api/genesis-model-api/retrieval-vector/embeddings.md)。

## 调试 Rerank

### 文本 Rerank

1. 选择 **重排序（文本）**。
2. 选择 Rerank 模型并设置 Top K。
3. 填写查询文本；在候选文档中每行填写一条候选内容。
4. 点击 **重排**，查看返回的候选顺序和相关性结果。

![文本 Rerank 调试页，包含模型、Top K、查询文本和逐行候选文档。](images/debug-text-rerank.png)

### 多模态 Rerank

1. 选择 **重排序（多模态）**。
2. 选择多模态 Rerank 模型并设置 Top K。
3. 填写查询文本和候选文本；需要比较图片时，填写候选图片 URL 或上传本地图片。
4. 点击 **重排**，查看结果。

![多模态 Rerank 调试页，包含查询文本、候选文本、候选图片 URL、本地图片上传和预览。](images/debug-multimodal-rerank.png)

重排序结果会标明每条结果对应原候选列表中的位置。候选文档请按每行一条输入；应用需要根据返回的位置，将排序结果对应回原始文档。具体返回字段请参阅[文本与多模态 Rerank](../../developer/api/genesis-model-api/retrieval-vector/rerank.md)。

## 排查未能运行的情况

| 现象 | 检查方式 |
| --- | --- |
| 无法选择模型或运行按钮不可用 | 确认已在[模型广场](models.md)选择相应任务类型的模型，并为当前服务账号授予该模型权限。 |
| 图文调试无法提交 | 确认选择支持视觉输入的模型，并检查图片 URL 或本地图片是否可用。 |
| Messages 或 Responses 返回不支持 | 切换到 Chat，或选择详情中明确支持相应调用形态的模型。 |
| 重排序结果不符合预期 | 检查查询、候选文档和 Top K；候选文档按每行一条输入。 |
| 需要确认实际 API 行为 | 进入相应的开发者接口页，核对请求参数、响应字段与错误处理。 |

调试确认模型满足需求后，复制模型 ID。在应用调用 API 时，将该 ID 填入请求的 `model` 字段；具体请求格式请参阅对应接口文档。