suixinkan_uikit/suixinkan/Features/TravelAlbum/AI自动修图接口补充.md

AI 自动修图接口补充

本文仅描述相册级自动修图新增契约；现有手动批量 AI 修图接口保持不变。

相册配置

create 请求新增：

{
  "auto_retouch_config": {
    "enabled": true,
    "refined_template_id": 12
  }
}

create、info、list 响应返回服务端规范化后的完整配置：

{
  "auto_retouch_config": {
    "enabled": true,
    "refined_template_id": 12
  }
}

旧相册缺少 auto_retouch_config 时，客户端按关闭处理。

更新配置

POST /api/yf-handset-app/photog/travel-album/auto-retouch-config
Content-Type: application/json

{
  "user_equity_travel_id": 88,
  "enabled": true,
  "refined_template_id": 12
}

响应 data 为服务端规范化后的完整配置。多设备同时修改时采用最后一次写入生效。

AI 任务提交

POST ai-retouch 请求和响应保持现状，不增加 client_request_id。请求结果不确定时客户端不得自动重复提交，应先同步素材或任务状态；无法确认时提示用户“提交状态未知”。

自动修图只使用现有模板接口的 refined_templates，不展示模板描述，也不自动生成氛围感或封面。