Skip to main content
通用任务 API 用于网关持久化的任务:提交、读取状态、列出产物和下载产物。它不接受任意供应商任务 ID,也不是 OpenAI Batch / Files API。使用提交响应中的公开任务 ID,并保持相同用户与项目权限。

提交与读取

按 REST 运行环境准备环境。仅在部署方确认该插件支持旧通用入口时使用 submit;task-request.json 必须是该插件的规范化请求对象,含 model,其他字段由插件决定。不能直接把所有供应商原生请求复制到此入口。通常优先使用已有的 图片、视频或 Responses 协议。
上述命令按步骤执行,submit 只执行一次,后续粘贴实际 ID。提交的 queued 是固定受理回执,甚至即时完成的任务也要查询最终状态。状态查询返回大写 NOT_START、SUBMITTED、QUEUED、IN_PROGRESS、SUCCESS、FAILURE、NEEDS_REVIEW 或 UNKNOWN。NEEDS_REVIEW 需要人工核对,UNKNOWN 不是成功;失败原因可能敏感,不直接写公共日志。 示例每次只查询一次,不轮询。status 成功退出表示读到有效状态,只有 completed: true 才表示任务 SUCCESS。应用若增加轮询,应设总截止时间、间隔和次数上限;截止或断连不会取消任务。没有通用取消、删除或列出全部任务的推理端点。

产物与下载

artifacts、head、download 会先确认 SUCCESS。成功任务仍可能返回空数组,例如插件不提供产物、结果未保留;不能硬编码 video 或猜测产物 key。列表含 key、type、可选 mime_type、content_url;示例只打印前三项,按列表 key 构造网关内的 Bearer 下载路径,不跟随重定向。 content_url 可能含临时签名,应当作临时访问凭据,不记录或拼接 API Key。示例不使用这个 URL;部署有额外 URL 前缀时由 API_ROOT_URL 提供。GET 支持整文件,HEAD 只检查可访问性;Range / 条件请求需另按 API 参考验证,HEAD 成功不保证随后下载永远有效。 本例下载最大 20 MiB,只在完整读取后新建文件,拒绝覆盖、空内容、非 200、HTML / JSON 和 MIME 不匹配。因而 JSON 类型的文件产物需要另写明确处理,不适用此媒体下载示例。它不解码验证图片、音频或视频内容,也不自动打开下载结果。 接口:提交、状态、列表、GET、HEAD。
Read in English