预览解析产物

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

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 不能作为预览依据。

请求示例

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。

后续操作

需要查看来源原文件时，使用预览来源原文件。

最后更新于