下载技能文件¶

下载随技能包导入的一个静态文件。成功响应为文件二进制内容，不使用 JSON 成功包络。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/skills/{skill_id}/files/content?path={path}

调用前准备¶

先查询技能文件取得 file_path。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和技能 ID。

请求参数¶

调用示例

curl -OJ "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/skills/$SKILL_ID/files/content?path=references%2Fguide.md" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

路径参数

参数	类型	是否必填	说明
`workspace_id`	string	是	当前工作区 ID。
`skill_id`	string	是	技能 ID。

查询参数

参数	类型	是否必填	说明
`path`	string	是	技能包内的文件相对路径。不能是目录、绝对路径、包含 `..` 或反斜杠的路径。

成功响应¶

成功时返回 200 和文件内容。响应不是 JSON 包络。响应设置以下头：

字段	类型	说明
`Content-Type`	响应头	文件的实际媒体类型。
`Content-Disposition`	响应头	`attachment`，并提供 UTF-8 编码的文件名。
`X-Content-Type-Options`	响应头	固定为 `nosniff`。

错误响应¶

响应示例

{
  "code": 3,
  "message": "<错误信息>",
  "details": {
    "reason": "SKILL_PACKAGE_FILE_NOT_FOUND"
  }
}

字段说明

错误时返回 JSON：

常见 HTTP 错误

通用字段

字段	类型	说明
`400`	`2`（`INVALID_ARGUMENT`）	常见原因：`path` 缺失或不是安全的技能包相对路径。建议操作：使用“查询技能文件”返回的 `file_path` 原样请求。
`401`	`6`（`UNAUTHENTICATED`）	常见原因：缺少有效身份凭据。建议操作：检查 API Key。
`403`	`5`（`PERMISSION_DENIED`）	常见原因：当前身份没有读取技能文件的权限。建议操作：检查工作区授权。
`404`	`3`（`NOT_FOUND`）	常见原因：技能或指定文件不存在。建议操作：检查技能 ID 和 `path`。
`503`	`15`（`UNAVAILABLE`）	常见原因：技能包存储不可用。建议操作：稍后重试。

后续操作¶

下载完成后如需继续管理，返回查询技能详情。

最后更新于 2026 年 9 月 8 日