爱创AI

为解决什么问题

电商运营者在日常工作中，需要高频次地生成商品图、视频、详情页等视觉素材。这个过程通常涉及打开专业设计软件、反复调整参数，并在不同平台（如图片生成、视频剪辑工具）间切换，流程割裂且耗时。对于开发者或自动化用户而言，更缺少一种能通过对话式指令、直接调用这些生成能力的服务化接口。

技能如何工作

本技能将“爱创AI”平台的核心功能封装为可编程调用的 API，允许你在 AI 对话中直接下达指令来生成内容。其核心是通过 HTTP 请求完成完整的创作流程。

核心能力覆盖

• AI 图片生成：支持包括 Agent 智能体模式在内的 18 种生成模式。Agent 模式是平台首推，用户上传参考图并描述需求后，AI 会自主分析并生成优化图片。其他模式如“去水印”、“AI 试衣”等有固定场景。
• AI 详情图生成：上传产品图后，AI 会自动分析并规划出一套完整的电商详情页（包含多个模块如卖点、参数等），然后逐张生成。
• 风格复刻：上传一组“参考设计图”和“产品素材图”，AI 学习参考图的风格后，将其应用到你的产品上，生成风格一致的新图。
• 视频生成：支持商品讲解、带货等多种类型的短视频生成。
• 资产管理：查询或批量管理你在平台上生成的所有图片、视频、详情图等资产。

关键工作流程

1. 认证与授权：所有 API 调用都需要一个用户的 Token。首次使用时，技能会引导用户通过浏览器登录爱创AI平台并复制其专属 Token。该 Token 会保存在会话上下文中，用于后续所有请求。
2. 任务提交：生成内容的核心操作是向 POST /api/v1/Task/Publish 端点发送请求。对于图片生成，需要在请求中指定 sceneMode（如 free_creation 对应自由创作或 Agent 模式）、提供 prompt（描述需求，这是必填项）以及参考图的 imageUrl。对于详情图和风格复刻，则需先创建批次（CreateBatch），然后分步确认方案和生成。
3. 资源处理：如果用户提供的是本地图片，技能会先将其编码为 Base64 并上传至平台 OSS，以获得可访问的 URL 用于后续生成。
4. 状态轮询与结果获取：提交任务后，会返回 taskJobId 或 conversationId。需要轮询 GetProgress 等接口查询任务状态，直到任务完成或失败，然后获取生成结果的 URL。
5. 会话管理与成本：为保持历史记录连续，技能在发布任务前会先查询并复用现有的 conversationId，不会为每次生成创建新会话。所有生成操作都会消耗积分，技能在提交前会告知用户预计的积分消耗。

适用边界与注意点

• Token 是必需凭证：没有有效的 Token，所有 API 调用都会失败（返回 401）。Token 的获取和保管责任在用户，且应在私密环境中使用。
• 积分模型：生成是计费的，不同功能积分不同（如图片生成通常 5 积分/张，详情图 15 积分/张）。技能会引用积分表进行提示，但精确余额查询需要额外的两步认证流程。
• Prompt 规则严格：对于非 Agent/自由创作的固定模式（如“去水印”），必须使用该模式预设的默认 prompt，否则任务会因参数错误而失败（错误码 999）。Agent/自由创作模式下，prompt 则由用户自由描述。
• 任务异步与队列：生成任务是异步处理的，提交后需要等待一段时间并主动查询结果。在高负载时，任务可能处于队列中，需要耐心轮询。
• API 操作的健壮性：技能提供了详细的 API 调用示例（覆盖 macOS/Linux 和 Windows），但在实际执行时，网络、超时、返回格式等都可能影响结果，需要做适当的错误处理。