4oImageApi.io 只留图 14 天,异步生图的终点应是归档
把 4oImageApi.io 接进设计后台的团队,应把任务成功与素材交付分开:按 taskId 跟踪状态,并在 14 天留存期内把结果保存到自己管理的存储。回调能通知完成,不能代替文件归档。
设计后台接上 4oImageApi.io 后,收到生成完成通知,就可以把任务关掉吗?如果这张图还要用于下个月的活动,答案是否定的。官方文档说明生成图像只保存 14 天。异步生成适合让后台把“提交请求”和“取得结果”分开处理,但团队还要补上自己负责的归档步骤。
这里依据文档分析一项内部素材生成任务,不是实际接口测试。假设设计师提交一张活动配图需求,开发者要交付的是一张能在自己的素材库重新打开的图片,而不只是服务端显示任务成功。
回调通知完成,状态查询帮助确认结果
文档说明,任务完成后会向指定回调地址发送 POST 通知;详情接口则可用 taskId 查询生成状态、参数与结果。接入时,应在自己的任务记录里把这次配图需求与 taskId 对应起来,让后续查询能找回原来的需求。
界面也应区分“生成中”和“可以交给设计师检查”。官方列出 GENERATING、SUCCESS、CREATE_TASK_FAILED、GENERATE_FAILED 等状态。收到通知后核对状态与结果,才能决定继续等待、处理失败,还是进入图片检查;不能把任何一次通知都当作拿到了可用素材。
如果采用轮询,文档规定每个任务最多每秒查询 3 次。这是查询上限,不是推荐频率,也不是每秒能生成 3 张图的承诺。团队应按等待体验安排查询间隔,并让重复查询停在任务终态,避免把状态监控误当成生图吞吐量。
14 天留存把归档变成接入的一部分
对下个月才使用的配图,只把供应方结果地址记进表格不够稳妥。既然图像会在 14 天后失效,就应在留存期内把选中的结果保存到自己管理的存储,再把内部素材位置写回任务记录。这个归档动作是接入方案需要实现的责任,不能从“支持回调”推导出产品会替你永久保存。
验收可以围绕同一项需求进行:确认结果能打开、图片符合设计要求、内部副本能独立读取,最后再把任务标为已交付。若生成成功但归档失败,应保留两种不同状态,以便补做保存,而不是让设计师误以为素材已经入库。这是一种建议的验收设计,本文没有验证其实际运行表现。
对于只需临时预览的内部实验,团队可以接受短期结果,但仍要告诉使用者留存边界;一旦素材要长期复用,就应先落实存储位置和失败处理责任,再扩大接入。4oImageApi.io 的异步能力提供了分开处理等待与通知的方式,团队的交付标准则应落在自己能持续取回的文件上。
内容说明:本文基于公开资料整理,仅供工具选型参考。产品功能、价格及相关政策可能随时调整,请以官方最新信息为准。
原文出处:docs.4oimageapi.io