商业级 AI 图像生成平台架构设计与技术选型实战

3.1 任务启动接口

该接口作为前端请求的入口点，负责接收用户的文本描述（Prompt）、待处理的图片文件等输入参数。服务端会严格验证用户的身份信息和积分余额，确保用户有权限且有足够的积分余额来执行此次操作。验证通过后，接口将调用 Replicate API 启动一个异步的图像生成任务。

为明确前后端数据的交互格式，该接口的请求体与响应体定义如下：

响应体（Response Body）：同样是一个 JSON 对象，格式如下：

{"taskId":"uuid","predictionId":"string","status":"processing"}

其中，taskId 是 Supabase 数据库中创建的任务记录 ID，predictionId 是 Replicate 返回的预测任务唯一标识符，前端可以使用这两个 ID 追踪任务的执行状态。

请求体（Request Body）：设计为一个包含多个字段的 JSON 对象，格式如下：

{"taskType":"text_to_image"|"image_edit"|"image_fusion","prompt":"string","inputImages":["string",...],"modelConfig":{...}}

其中，taskType 字段用于区分不同的生成模式，prompt 用于存储用户的文本描述，inputImages 为图片 URL 数组，modelConfig 存储模型的具体配置参数。

3.2 Webhook 回调接口

这是一个完全被动的服务端接口，仅负责接收来自 Replicate 服务器的 HTTP POST 通知。当图像生成任务完成时（无论成功还是失败），Replicate 都会主动向预先配置好的 Webhook 地址发送一个包含任务结果的请求。

接口处理逻辑遵循严格的安全和业务流程：先验证接收到的请求是否真正来自 Replicate（通常通过签名进行验证），然后根据请求中携带的 predictionId 在数据库中匹配对应的任务记录并更新其状态；如果任务执行成功，接口还需要完成一系列后续操作——从 Replicate 临时存储服务器下载生成的图片，将其永久保存到我们自己的 Supabase Storage 中，同时扣除用户相应的积分。

该接口的前后端数据的交互格式定义如下：

• 响应体（Response Body）：接口处理完成后，返回简单的 200 OK HTTP 状态码，告知 Replicate 服务器已成功接收并处理了这次通知。

请求体（Request Body）：格式由 Replicate 官方定义，包含的核心字段如下：

{"id":"replicate_prediction_id","status":"succeeded"|"failed","output":["url",...],"error":"string","metrics":{...}}

其中，id 是预测任务 ID，status 表示任务执行结果，output 是生成的图片 URL 数组，error 记录失败原因，metrics 提供性能指标。

这种分离'任务发起'和'结果处理'的异步设计，是构建 AI 计算、视频转码、批量邮件发送等所有长耗时任务的行业标准模式。