# 预览解析产物

以二进制流预览知识库文件解析产生的产物，例如解析图片。

```text
GET https://moi.matrixorigin.cn/newmoi/semantic-models/{model_id}/artifacts/{file_id}/preview
```

## 调用前准备

准备有目标知识库读取权限的 `$AI_STUDIO_API_KEY`、`$WORKSPACE_ID`、`$MODEL_ID` 和 `$FILE_ID`。此 `file_id` 必须是该知识库来源文件关联的解析产物；仅知道一个 Catalog 文件 ID 不能作为预览依据。

## 请求示例

```bash
curl -L "https://moi.matrixorigin.cn/newmoi/semantic-models/$MODEL_ID/artifacts/$FILE_ID/preview" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -o artifact.bin
```

## 成功响应

成功时返回 `200` 和产物二进制流，不使用 JSON 响应信封。

| Header | 说明 |
| --- | --- |
| `Content-Type` | 产物 MIME 类型；未识别时为 `application/octet-stream`。 |
| `Content-Disposition` | 有文件名时返回内联预览文件名。 |

## 常见错误

| HTTP 状态码 | 错误代码 | 常见原因 | 建议操作 |
| --- | --- | --- | --- |
| `400` | `ErrParamInvalid` | `model_id` 或 `file_id` 无效。 | 使用非空、无首尾空白的产物文件 ID。 |
| `403` | `ErrForbidden` | 没有目标知识库读取权限。 | 检查工作区和知识库授权。 |
| `404` | `ErrNotFound` | 产物未关联到该知识库的来源文件。 | 确认知识库 ID 和解析产物 ID。 |

## 后续操作

需要查看来源原文件时，使用[预览来源原文件](preview-source-file.md)。