介绍
# AI Picture Book
根据故事或描述生成绘本视频。
## 工作流
1. **创建任务**：提交故事 + 类型 → 获取任务 ID 2. **轮询状态**：每 5-10 秒查询一次，直到完成 3. **获取结果**：当状态 = 2 时，检索视频 URL
## 绘本类型
| 类型 | 方法 | 描述 | |------|--------|-------------| | 静态 | 9 | 静态绘本 | | 动态 | 10 | 动态绘本 |
**必填**：用户必须指定类型（静态/9 或 动态/10）。如果未提供，请让他们选择。
## 状态码
| 代码 | 状态 | 操作 | |-------|---------|---------| | 0, 1, 3 | 进行中 | 继续轮询 | | 2 | 已完成 | 返回结果 | | 其他 | 失败 | 显示错误 |
## APIs
### 创建任务
**端点**：`POST /v2/tools/ai_picture_book/task_create`
**参数**： - `method`（必填）：`9` 代表静态，`10` 代表动态 - `content`（必填）：故事或描述
**示例**： ```bash python3 scripts/ai_picture_book_task_create.py 9 "A brave cat explores the world." ```
**响应**： ```json { "task_id": "uuid-string" } ```
### 查询任务
**端点**：`GET /v2/tools/ai_picture_book/query`
**参数**： - `task_id`（必填）：来自创建端点的任务 ID
**示例**： ```bash python3 scripts/ai_picture_book_task_query.py "task-id-here" ```
**响应**（已完成）： ```json { "status": 2, "video_bos_url": "https://...", } ```
## 轮询策略
### 自动轮询（推荐） ```bash python3 scripts/ai_picture_book_poll.py <task_id> [max_attempts] [interval_seconds] ```
**示例**： ```bash # Default: 20 attempts, 5s intervals python3 scripts/ai_picture_book_poll.py "task-id-here"
# Custom: 30 attempts, 10s intervals python3 scripts/ai_picture_book_poll.py "task-id-here" 30 10 ```
### 手动轮询 1. 创建任务 → 存储 `task_id` 2. 每 5-10 秒查询一次，直到状态 = 2 3. 2-3 分钟后超时
## 错误处理
- 内容无效：“内容不能为空” - 类型无效：“类型无效。请使用 9（静态）或 10（动态）” - 处理错误：“生成绘本失败” - 超时：“任务超时。请稍后重试”