易企秀 AIGC H5 HTTP 调用
- 命令行：
python scripts/eqxiu_aigc_client.py ...
- 鉴权：客户端支持
X-Openclaw-Token 登录、状态校验与自动透传。
- 获取
X-Openclaw-Token地址：https://www.eqxiu.com/skillAccess/token
调用顺序（必须遵守）
认证（推荐先执行）
# 交互式保存 token 到 ~/.eqxiu/config.json，如果存在token，验证token有效性即可
python scripts/eqxiu_aigc_client.py login
# 校验 token 是否有效
python scripts/eqxiu_aigc_client.py auth status
说明：
auth status 返回 {"success": true, "code": 200, ...} 代表 token 有效。- 返回
{"success": false, "code": 1002, "msg":"认证失败", ...} 代表 token 无效。
- 也可用
--access-token 覆盖配置中的 token。
易企秀链路依赖上游返回字段，不要颠倒顺序。
GET /iaigc/category — 列出制作种类。每条含 categoryId、name、desc、fields、twoLevelCategoryId、threeLevelCategoryIds（数组）等。- （可选）
GET /iaigc/style — 查风格列表，供 scene-tpl 的 styleId。需要某条品类里的 twoLevelCategoryId 与 threeLevelCategoryIds 中的某一个三级 id（整数）。支持查询参数 pageNo（默认 1）、pageSize（默认 20，上限 100）。成功时本服务响应体里的 data 与易企秀分页一致：{ pageNo, pageSize, total, data }，其中内层 data 为模板完整对象数组（每项含 id、productTitle、sceneExtract 等）；选风格时一般用每项的 id 作为 styleId。
POST /iaigc/outline — 提交 sceneFields + categoryId（等于所选品类的 categoryId）。返回 imageId、outline、outlineTaskId。POST /iaigc/scene-tpl — 提交与步骤 3 相同的 sceneFields 与 相同的品类 id 作为 sceneId，并带上步骤 3 的 title（用户给定）、outlineTaskId、outline；建议带上 imageId（来自步骤 3）；若步骤 2 选了模板则带 styleId。
对话中向用户确认：title、各 field 的文案、是否指定 styleId（可先展示 style 接口返回的 id/productTitle 等字段）。
构造 sceneFields
- 根据步骤 1 返回条目的
fields（及业务说明）组装数组：[{"id": <整数>, "value": "<字符串>"}, ...]。
id 必须与品类定义的字段 id 一致；缺字段或错 id 易导致上游失败。
客户端脚本
以下命令均在 skills/eqxiu-h5creator/scripts/ 下执行（或任意目录使用脚本绝对路径）；实现代码在同级包 eqxiu_aigc/。
创作主链路（iaigc）
# 1) 品类列表
python scripts/eqxiu_aigc_client.py category
# 2) 风格（示例 id 需换成品类数据中的真实值）
python scripts/eqxiu_aigc_client.py --access-token xxx style --two <twoLevelCategoryId> --three <某个threeLevelCategoryId>
# 3) 仅生成 outline
python scripts/eqxiu_aigc_client.py --access-token xxx outline --category-id <categoryId> --fields-json '[{"id":1,"value":"某主题"}]'
# 4) 仅生成 scene-tpl（body 需含完整 JSON，通常由 outline 结果拼装）
python scripts/eqxiu_aigc_client.py --access-token xxx scene-tpl --json-file path/to/body.json
# 一键：outline → scene-tpl（同一 categoryId、同一份 sceneFields）
python scripts/eqxiu_aigc_client.py --access-token xxx pipeline --category-id <id> --title "作品标题" --fields-json '[...]' [--style-id <可选>]
# 文本修正并发布（作品须归属当前用户）
python scripts/eqxiu_aigc_client.py --access-token xxx validate-fix --scene-id <scene_id> --page-id <page_id> --element-id <element_id> --content "修正后的文案" [--preview-url "<previewUrl>"]
素材库（易企秀 material-api，非 iaigc）
| 目的 | CLI 子命令 | 说明 |
|---|
| 查询素材 | material-list | 分页列出当前用户已上传素材（默认 fileType=1 图片）。 |
| 文件上传 | upload | 需 pip install cos-python-sdk-v5。 |
# 查询当前用户上传素材（换图前可先查已有 path，或给用户选图）
python scripts/eqxiu_aigc_client.py --access-token xxx material-list [--page-no 1] [--page-size 30] [--file-type 1] [--tag-id -1]
# 本地文件上传 COS 并登记素材库；成功 JSON 中含 cos.key / cos.assetUrl、material（业务对象，含可用于 H5 的 path 等字段，以实际返回为准）
python scripts/eqxiu_aigc_client.py --access-token xxx upload --file /path/to/image.png
### 作品内「正文配图」（本服务 iaigc + 易企秀 gRPC，需作品归属用户换图）
| 目的 | CLI 子命令 | 对应 HTTP |
|------|------------|-----------|
| **查询可替换图片** | `body-images` | `GET /iaigc/h5_scene/get_body_images?id=<scene_id>&page_id=<可选>` |
| **替换图片** | `replace-body-image` | `POST /iaigc/h5_scene/replace_body_image` |
```bash
# 列出作品中 name=正文配图 的图片：每页含 elements[].id / src / src_url，供换图参数
python scripts/eqxiu_aigc_client.py --access-token xxx body-images --scene-id <scene_id> [--page-id <仅某一页>]
# 将某一 element 换为新图；--src 一般为素材 path 或与生成作品时一致的 asset 路径（可先 upload 再取 material 或 cos.key）
python scripts/eqxiu_aigc_client.py --access-token xxx replace-body-image --scene-id <scene_id> --page-id <page_id> --element-id <元素id> --src "<新图 path 或 URL>" [--source-id <可选>]
换图推荐顺序：body-images 拿到 page_id + element_id + 当前 src →（如需新文件）upload 得到可写进作品的 src → replace-body-image。pipeline 成功后的 validation.body_images 与 body-images 结构一致，可跳过首次查询。
所有需鉴权的子命令都会携带 X-Openclaw-Token（--access-token 或 ~/.eqxiu/config.json）。
pipeline 子命令内部顺序固定为：先 create_outline，再 create_scene_tpl，并把 outlineTaskId、outline、imageId 自动传入第二步；最后会自动读取可编辑文本与正文配图列表，输出到 validation.editable_text、validation.body_images 供大模型校验与换图（换图失败时 body_images 可能为空数组）。
二次编辑（文本 + 素材 + 配图）
文本
当 pipeline 返回 validation.editable_text 后，先让大模型判断文本是否需要修正；若需要，调用 validate-fix 执行修正并发布：
# 1) 先执行 pipeline，拿到 validation.editable_text 给大模型判断
python scripts/eqxiu_aigc_client.py --access-token xxx pipeline --category-id <id> --title "作品标题" --fields-json '[...]'
# 2) 若有问题，调用 validate-fix 按元素修正（自动 publish）
python scripts/eqxiu_aigc_client.py --access-token xxx validate-fix --scene-id <scene_id> --page-id <page-id> --element-id <element_id> --content "更新后的文案" --preview-url "<previewUrl>"
素材与正文配图
- 查询素材：
material-list 调易企秀 material-api 的 list2；从返回里取可用于作品的图片 path/url（字段名以实际 JSON 为准）。
- 上传文件：
upload 走 COS + saveFile；依赖 cos-python-sdk-v5。上传成功后用返回中的路径作为 replace-body-image --src 的输入（与作品内 properties.src 格式一致即可）。
- 查询可替换图片：
body-images 或直接使用 pipeline 输出的 validation.body_images；仅包含 name=正文配图 且类型为图片的组件。
- 替换图片：
replace-body-image 必须带作品归属用户同一 token；element_id 须与 body-images 中某项一致，否则接口会拒绝。
返回与使用要点：
pipeline 会自动输出 validation.editable_text、validation.body_images；后者在部分环境拉取失败时可能为空数组，可再执行一次 body-images。validate-fix 必要参数：scene-id、page-id、element-id、content。- 文本修正后把
previewUrl 返回给用户；换图成功后服务端同样会 publish，可再次打开预览链接确认。
- 细调文字样式可在
validate-fix 中使用 --css-json。
代理在对话中的建议流程
- 执行
category（或 GET），让用户选定品类；记录 categoryId 与 fields。
- 询问用户各字段文案，组装
sceneFields。
- 若需要固定风格：用该品类的
twoLevelCategoryId 与选定的三级 id 调 style，用户选 styleId。
- 调
outline（或 pipeline 前半段）；失败则根据 msg 重试或改字段。
- 调
scene-tpl（或 pipeline 一次性完成）；成功 data 一般为 {"sceneId":{id},"previewUrl":"https://h5.eqxiu.com/s/{code}"}, "editUrl"：https://www.eqxiu.com/c/{id}（以服务实际返回为准），点击链接登陆后就可以编辑了。
- 把
validation.editable_text 交给大模型审查；有问题则 validate-fix 并交付 previewUrl。
- （可选） 若用户要换内页配图：根据
validation.body_images（或 body-images）定位 page_id / element_id；若需新图则先 upload 再 replace-body-image --src …；若从已有素材选图则先 material-list 再换图。
超时与错误
outline、scene-tpl 可能极慢，客户端默认超时约 900s；可用 --timeout 调整。素材 list2、COS 相关请求使用较短超时（由客户端内部限制，避免拖死长轮询）。iaigc 业务错误多为 success: false 与 msg；脚本非零退出并打印 JSON。upload / material-list 失败时也会打印结构化 JSON（含 code/msg）。
