图像生成

概述

生产流程使用 Kie.ai GPT Image 2，将两张属于当前账户的独立参考照片合成为一张订婚肖像。

端点

POST /api/image/generate

请求

{
  "imageUrl": "https://media.example.com/uploads/user/person-a.jpg",
  "partnerImageUrl": "https://media.example.com/uploads/user/person-b.jpg",
  "styleKey": "editorial",
  "customPrompt": "可选的场景细节"
}

两个 URL 都必须属于当前登录账户。服务端负责验证风格并生成提供商提示词。

响应流程

1. 验证用户会话和积分
2. 在一个事务中预留 1 积分并创建处理中记录
3. 将两张源图发送给 Kie.ai GPT Image 2
4. 试用预览在服务端加水印，并将结果上传到 R2
5. 保存到 generationHistory 表
6. 返回图片 URL 和剩余积分；提供商或存储失败时退还积分

存储

订婚照流程必须配置 R2。生成结果会立即镜像，历史记录不会依赖可能过期的第三方 URL。

历史记录

所有生成记录保存在 generationHistory 表中：

• type — image
• prompt — 用户的提示词
• resultUrl — 生成图片的 URL
• status — completed 或 failed
• creditsUsed — 消耗的积分