# 下载请求或响应正文

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

下载一次模型调用已归档的完整请求或响应正文。

```text
GET https://billing.moi.matrixorigin.cn/api/v1/taas/usage-logs/{id}/bodies/{body_ref_id}
```

## 调用前准备

1. 准备个人访问令牌。创建和管理方法参阅[创建和管理个人访问令牌](../../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)。
2. 通过[查询请求日志列表](list-request-logs.md)选择要查询的调用。
3. 通过[查询请求日志详情](get-request-log.md)确认所需正文已完成归档。

下载内容可能包含用户输入和模型输出，请保存到受控位置。

## 请求示例

将示例中的 `$MOI_PERSONAL_ACCESS_TOKEN`、`$USAGE_LOG_ID` 和 `$BODY_REF_ID` 分别替换为个人访问令牌、所选请求日志的 ID 和正文归档引用 ID。

```bash
curl "https://billing.moi.matrixorigin.cn/api/v1/taas/usage-logs/$USAGE_LOG_ID/bodies/$BODY_REF_ID" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN" \
  --output body.bin
```

## 路径参数

::::{div} mo-api-parameter-table

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `id` | string | 是 | 所选请求日志的 ID，取自请求日志列表中的 `items[].id`。 |
| `body_ref_id` | string | 是 | 同一请求日志的正文归档引用 ID，取自详情中的 `request_body_ref_id`、`response_body_ref_id` 或 `body_refs[].id`。 |

::::

## 成功响应

返回 HTTP `200`，响应体为完整正文的原始字节，示例将其保存为 `body.bin`。媒体类型为 `application/octet-stream`。

以下响应头在有对应值时返回。

| 响应头 | 类型 | 说明 |
| --- | --- | --- |
| `X-Body-Scope` | string | 正文所属请求或响应阶段；有值时返回。 |
| `X-Body-SHA256` | string | 完整正文的 SHA-256；有值时返回，可用于校验下载内容。 |
| `X-Body-Bytes` | integer | 完整正文的字节数；大于 0 时返回。 |