library-picturebook-activity/lesingle-aicreate-client/demo/README.md

C 端接入 Demo

乐读派 AI 创作系统 C 端接入参考代码。

文件说明

文件	说明
HmacSigner.js	HMAC-SHA256 签名工具（所有 C 端 API 均需签名）
CreationApi.js	API 封装（A1-A4 创作 + B1-B6 查询）
CreationProgressTracker.js	创作进度追踪器（WebSocket + HTTP 双通道）
example-usage.js	完整接入示例（4 个场景）

快速接入

1. 安装依赖

npm install crypto-js sockjs-client @stomp/stompjs

2. 最简接入（纯 HTTP 轮询）

import CreationApi from './CreationApi.js'

const api = new CreationApi('https://server.com', 'ORG001', 'your-secret')

// 创作
const { workId } = await api.createBySentence({
  orgId: 'ORG001', phone: '13800138000',
  sentence: '小恐龙学游泳', style: 'style_cartoon'
})

// 轮询直到完成
const poll = setInterval(async () => {
  const data = await api.getWork(workId)
  console.log(`${data.progress}% - ${data.progressMessage}`)
  if (data.status === 'COMPLETED' || data.status === 'FAILED') {
    clearInterval(poll)
    console.log(data.status === 'COMPLETED' ? data.pageList : data.failReason)
  }
}, 5000)

3. 最佳体验（WebSocket + 自动降级）

import CreationApi from './CreationApi.js'
import CreationProgressTracker from './CreationProgressTracker.js'

const api = new CreationApi('https://server.com', 'ORG001', 'your-secret')
const { workId } = await api.createBySentence({ ... })

const tracker = new CreationProgressTracker({
  serverUrl: 'https://server.com',
  orgId: 'ORG001', appKey: 'ORG001', appSecret: 'your-secret',
  workId,
  onProgress: (pct, msg) => updateUI(pct, msg),
  onComplete: (result) => showResult(result)
})
tracker.start()

// 用户离开页面时
tracker.stop()

接口清单

接口	方法	路径	签名	说明
B1	POST	/api/v1/query/validate	需要	校验额度
B2	GET	/api/v1/query/work/{workId}	需要	作品详情+实时进度
B3	GET	/api/v1/query/works	需要	作品列表
B6	GET	/api/v1/query/styles	不需要	画风列表
A1	POST	/api/v1/creation/one-sentence	需要	一句话创作
A2	POST	/api/v1/creation/scene-elements	需要	四要素创作
A3	POST	/api/v1/creation/image-story	需要	图片故事创作
A4	POST	/api/v1/creation/video	需要	视频合成

进度追踪策略

WebSocket 连接成功
  │ 实时推送 progress + message
  │
  ├─ 断连 → 自动重连（3秒间隔）
  │          同时启动 B2 HTTP 轮询补位（5秒间隔）
  │
  ├─ 重连成功 → 停止轮询，恢复 WebSocket
  │              立即查一次 B2 补齐断连期间状态
  │
  └─ progress=100 或 -1 → 查 B2 获取完整数据 → onComplete 回调