useAiWork开发者文档
AI 开发

图片生成、异步任务与历史

区分平台图片与自有密钥任务,维护幂等创建和可恢复查询。

两种路径

平台生图使用平台配置和积分。自定义图片连接独立于文本连接,目前有多米 GPT Image 与 Nano Banana 适配;模型清单和模式能力以 src/ai/image/providers 与 Schema 为准。

自有密钥不扣平台积分,但供应商仍可能按请求收费。保存连接配置不会自动执行付费生成。

异步任务

多米创建返回上游任务 ID,当前查询复用 GET /v1/tasks/{id}。Nano Banana 查询协议仍需真实供应商联调确认,已有适配和测试不能证明供应商服务在线兼容。

轮询每 2.5 秒执行一次,单轮最长 10 分钟。停止只暂停本站查询,上游没有提供取消 API;继续查询不会重新创建付费任务。

历史与幂等

创建前预留历史,同一 requestId 避免重复创建。历史按账户保存任务、模型身份、参数、进度与结果引用,不保存 API Key。

更新使用 revision,迟到查询不能覆盖暂停或删除。配置删除或地址改变时要求恢复原连接,不回退到平台。创建返回任务 ID 前断线时可能无法确定上游是否已收费,不自动重试创建。

结果存储

平台图片存入对象存储,数据库保存受保护的本站地址;读取须匹配历史所有者。删除历史后本站图片入口不可访问,当前存储抽象没有物理删除方法,对象清理由生命周期策略管理。

自定义模型图片由供应商托管,地址可能有有效期。继续图生图前检查结果地址及参数约束。

实现入口

  • src/ai/image/model-schema.ts:参数、模式与模型能力。
  • src/ai/image/providers/duomi:供应商请求与结果映射。
  • src/ai/image/poll-task.ts:顺序轮询与取消。
  • src/features/ai-image/api/history-core.ts:历史业务核心。
  • src/features/ai-image/use-image-history.ts:恢复、暂停与账户生命周期。

相关测试位于 src/test/ai-image。

本页目录