提交一次,保留原任务编号
生成可能直接返回结果,也可能返回task_id。保存原编号、模型、输入和返回的状态,查询这个任务直到完成或明确失败。按真实返回值解释状态,不把工具等待超时写成生成失败。
当前已发布 CLI 和 MCP 没有可用的公开取消排队入口。关闭终端、聊天或连接不等于取消,也不证明未扣费。
超时或结果未知时怎样恢复
1
保留原身份和提交记录
CLI 保存 quote_id 和原恢复记录;MCP 保存 client_request_id、原输入及错误。已有 task_id 时优先查询这个编号,不重新调用生成。
3
确认任务与账务事实
返回完成结果后保存原件;明确失败后核对实际账务;仍未知时保留错误与时间并联系支持。未知结果不是“没有生成”,也不是“没有扣费”。
素材要先变成模型可读取的输入
- 核对模型接受的图片、视频、音频类型、数量、大小和参考组合。
- 使用执行环境可以读取的本地文件,或服务端可以访问的 URL。聊天附件和桌面路径不会自动变成远程可读取文件。
- 上传后确认回执与文件 URL,再填入模型输入并重新估价。
- 上传结果未知时保留原 upload_id 查询。确认失败或授权过期后再申请新上传,回执能力取决于文件服务部署。
有效期与保存
具体以实际返回值为准,上传回执兼容取决于文件服务部署。本地下载成功的原件由用户保存;临时 URL、文档和聊天附件不能替代长期保存。过期素材需重新上传,更新输入后重新确认。
下载与预览排错
- 查原任务并确认完成,使用任务返回的原件 URL。过期、私有或无效链接不能靠改请求头修复。
- CLI 可用 download 命令;MCP 用户可以在浏览器打开原件,或让具备文件能力的环境保存。具体命令见CLI 下载和MCP 交付。
- 核对 HTTP 状态、Content-Type 和实际文件格式。错误 HTML/JSON 不能作为媒体交付。后缀匹配真实格式,不把所有图片都重命名成 PNG。
- 灰色缩略图或只显示链接时先打开原件。原件正常就交付并保存;预览由宿主决定,不能通过未经批准的重新生成或剪辑修复灰框。