重试导入失败文件¶

重试导入任务中指定的失败文件，或该任务的全部失败文件。成功响应仅表示重试请求已受理。

POST https://api.moi.matrixorigin.cn/v5/task/retry

调用前准备¶

准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和任务 ID。先查看导入任务文件列表选择失败文件；任务必须处于已完成或失败状态。

请求体¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID、$TASK_ID 和 $FILE_ID 替换为实际值。

输入示例

重试指定失败文件

curl -X POST "https://api.moi.matrixorigin.cn/v5/task/retry" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{\n    \\"task_id\\": \\"$TASK_ID\\",\n    \\"ids\\": [\"$FILE_ID\"]\n  }"

重试全部失败文件

省略 ids，服务会选择该任务中当前所有失败文件。

curl -X POST "https://api.moi.matrixorigin.cn/v5/task/retry" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{\n    \\"task_id\\": \\"$TASK_ID\\"\n  }"

参数说明

重试指定失败文件

参数	类型	是否必填	说明
`task_id`	string	是	导入任务 ID。
`ids`	array of string	是	要重试的失败文件 ID 列表。每个 ID 必须属于该任务并处于失败状态。

重试全部失败文件

参数	类型	是否必填	说明
`task_id`	string	是	导入任务 ID。

成功响应¶

请求已受理不表示文件已完成处理。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	null	不返回重试运行记录。

错误响应¶

响应示例

{
  "code": "ErrServer",
  "msg": "task must be finished or failed before retry",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	可读错误信息。
`data`	null	错误响应中为 `null`。

后续操作¶

再次查看导入任务文件列表和查看导入任务运行记录列表，确认失败项和运行状态。

最后更新于 2026 年 9 月 28 日