使用临时能力链接读取文件

供外部模型提供方按签发链接读取一个文件的内容。

GET https://api.moi.matrixorigin.cn/v5/catalog-files/{file_id}/content

调用前准备

先由有读取权限的身份签发模型链接,将返回的完整url设为MODEL_FILE_URL;到期时间使用expires_at。

请求参数

curl --fail-with-body -sS -X GET "$MODEL_FILE_URL" \
  -o "$OUTPUT_FILE"

字段

类型

是否必填

说明

file_id

string

是

路径中的文件ID,必须与签名绑定文件一致。

capability

string

是

唯一一次出现的查询参数,使用签发链接中的值。

直接访问签发url,无需产品PAT或工作区头。签名绑定工作区、文件及到期秒数。缺失/无效/过期/文件不可读/内容为空统一对外404;成功字节带no-store及no-referrer等响应头。

成功响应

sample

响应为字节流;消费并关闭流,检查读取/退出状态后使用文件。响应开始后失败可中断连接。

错误响应

{
  "code": "ErrNotFound",
  "msg": "示例本地化错误"
}

对外错误使用字符串code/msg,隐藏签名或存储内部原因。

最后更新于