三行诗点评助手

三行诗点评助手用于把单张照片生成简短诗性表达，并支持诗卡展示与下载。

触发条件

• 在照片点评入口选择三行诗助手并发起生成。
• 助手需处于启用状态，且账号在可用配额内。
• 输出需要满足三行结构（lines 长度为 3）才能用于诗卡链路。

风格说明

• 目标是“短、准、有余韵”，强调画面感和留白。
• 一般不追求长篇解释，优先凝练表达。
• 风格由助手模板决定，可因助手配置不同而变化。

操作步骤

1. 打开照片详情，进入 AI 点评。
2. 选择三行诗助手并提交。
3. 生成成功后查看三行结果。
4. 需要分享时，进入诗卡导出（数据或图片）。

输入输出示例

示例：生成点评

POST /api/photos/{photoId}/ai-review
Content-Type: application/json

{
  "assistantId": "assistant_poem_xxx"
}

示例：点评响应（节选）

{
  "review": {
    "lines": [
      "风从石阶上慢下来",
      "你把黄昏折成一张票根",
      "我在光里读到回家的路"
    ]
  }
}

示例：诗卡数据

GET /api/photos/{photoId}/reviews/{reviewId}/poem-card-data

{
  "photoUrl": "https://...",
  "lines": ["...", "...", "..."],
  "assistantName": "三行诗助手"
}

注意事项

• 非三行结构会被判定为“当前点评不是三行诗”，无法生成诗卡。
• 诗卡链路依赖源图读取与解析，图片异常会导致导出失败。
• 流式生成异常时会尝试降级到非流式，仍失败才返回错误。

失败重试建议

1) 命中配额或频控

• 现象：返回 429 或提示次数限制。
• 处理：等待配额恢复，或切换可用助手。

2) 助手不可用

• 现象：助手不存在、停用或未公开。
• 处理：更换助手，或让管理员检查助手状态。

3) 诗卡生成失败

• 现象：返回“不是三行诗”或图片处理错误。
• 处理：先确认点评确实是三行，再重试导出；必要时重新生成点评。

相关页面

• AI 能力中心总览
• 语义搜索
• AI 能力 FAQ