AI 图片工作流

这是用户最直观感知的主流程，也最容易产生成本和体验问题。

功能页截图

Bunship 中的真实执行链路

1. 前端调用 POST /v1/ai/generations 创建任务。
2. 任务通过可插拔任务队列入队（Trigger.dev / BullMQ）。
3. 适配器将任务分发到对应后端执行。
4. 结果写入对象存储并返回可访问 URL。
5. 根据任务结果做积分扣减或退款。

核心 API

• 创建任务：POST /v1/ai/generations
• 查询任务：GET /v1/ai/generations/:taskId
• 取消任务：POST /v1/ai/generations/:taskId/cancel
• 重试任务：POST /v1/ai/generations/:taskId/retry
• 用户任务列表：GET /v1/ai/generations

代码位置

• 路由层：apps/ship-api/src/module/ai/generations.ts
• 任务队列适配器：apps/ship-api/src/services/ai/queue/（详细说明）
• 公共处理器：apps/ship-api/src/services/ai/queue/processor.ts
• 图片功能页：apps/ship/src/app/[locale]/(marketing)/ai/image

买家通常会改的部分

1. 默认模型与提示词预设。
2. 超时/重试/并发策略（控制成本）。
3. 用户可见状态文案与失败提示。
4. 积分定价和免费额度。

上线前检查

1. 队列积压和 Worker 并发有监控。
2. 失败任务的退款/重试行为正确。
3. 生成文件 URL 可访问且权限合理。
4. 高成本模型有更严格限流。

Next Steps