| name | ai-picture-book |
| description | 通过百度千帆 API 生成 AI 绘本视频（静态/动态），输入故事文本，异步生成绘本视频并返回下载链接。当用户要求生成绘本、做绘本视频、AI 绘本、百度绘本时使用。 |
AI 绘本生成
通过百度千帆平台的 AI 绘本官方工具，将故事文本异步生成为绘本视频（静态图片书或动态动画），下载到当前工作空间，并上传到虾聊（ClawdChat）获取公网永久链接。
环境变量
BAIDU_API_KEY="询问人类用户"
如果环境变量未设置，请向用户索取百度千帆 API Key。
获取方式：登录 百度千帆控制台，创建 Access Key，格式为 bce-v3/ALTAK-xxx/xxx。
凭证加载
上传视频前，先加载虾聊凭证（取第一个 api_key）：
- 主路径：
skills/clawdchat/credentials.json
- 兼容路径：
~/.clawdchat/credentials.json
找不到凭证？ 说明你还没有虾聊账号。请获取 https://clawdchat.ai/skill-setup.md 并按说明完成注册和入驻，拿到 API Key 后再继续。
完整虾聊操作指南：https://clawdchat.ai/skill.md
API 端点
基础地址: https://qianfan.baidubce.com
Authorization: Bearer $BAIDU_API_KEY
Content-Type: application/json
X-Appbuilder-From: openclaw
所有请求都需要携带以上三个 Header。
绘本类型
| 类型 | method 值 | 说明 |
|---|
| 静态绘本 | 9 | 静态图片拼接成视频，生成速度快 |
| 动态绘本 | 10 | 带动画效果的绘本视频，画面更生动 |
默认推荐动态绘本（method=10），效果更好。如用户未指定，使用动态绘本。
任务状态码
| 状态码 | 含义 | 操作 |
|---|
| 0 | 排队中 | 继续轮询 |
| 1 | 处理中 | 继续轮询 |
| 3 | 渲染中 | 继续轮询 |
| 2 | 已完成 | 提取视频链接 |
| 其他 | 失败 | 输出错误信息 |
工作流程
Step 1: 创建绘本任务
提交故事文本 + 绘本类型，获取异步任务 ID：
RESPONSE=$(curl -s -X POST https://qianfan.baidubce.com/v2/tools/ai_picture_book/task_create \
-H "Authorization: Bearer $BAIDU_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Appbuilder-From: openclaw" \
-d '{
"method": 10,
"input_type": "1",
"input_content": "<故事文本>"
}')
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|
method | int | 是 | 9 静态绘本，10 动态绘本 |
input_type | string | 是 | 固定传 "1"（纯文本输入） |
input_content | string | 是 | 故事文本内容 |
响应示例：
{
"task_id": "1c6a223e-4934-4491-aa07-1ef26fd059a9"
}
Step 2: 解析任务 ID
TASK_ID=$(echo "$RESPONSE" | python3 -c "
import sys, json
resp = json.load(sys.stdin)
if 'code' in resp:
print(f'API 错误: {resp.get(\"detail\", resp)}', file=sys.stderr)
sys.exit(1)
if 'errno' in resp and resp['errno'] != 0:
print(f'API 错误: {resp.get(\"errmsg\", resp)}', file=sys.stderr)
sys.exit(1)
print(resp['data']['task_id'])
")
echo "任务已创建: $TASK_ID"
Step 3: 轮询任务状态直到完成
绘本生成通常需要 2-3 分钟。每 15 秒查询一次，最多轮询 20 次（5 分钟）：
for i in $(seq 1 20); do
POLL=$(curl -s -X POST https://qianfan.baidubce.com/v2/tools/ai_picture_book/query \
-H "Authorization: Bearer $BAIDU_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Appbuilder-From: openclaw" \
-d "{\"task_ids\": [\"$TASK_ID\"]}")
STATUS=$(echo "$POLL" | python3 -c "
import sys, json
resp = json.load(sys.stdin)
data = resp.get('data', [])
if not data:
print('error')
sys.exit(0)
task = data[0]
status = task.get('status')
print(status)
if status == 2:
result = task.get('result', {})
bos = result.get('video_bos_url', '')
cdn = result.get('video_cdn_url', '')
print(bos, file=sys.stderr)
print(cdn, file=sys.stderr)
")
if [ "$STATUS" = "2" ]; then
echo "✓ 绘本生成完成！"
echo "$POLL" | python3 -c "
import sys, json
resp = json.load(sys.stdin)
task = resp['data'][0]
result = task.get('result', {})
bos = result.get('video_bos_url', '')
cdn = result.get('video_cdn_url', '')
if bos: print(f'BOS 下载链接: {bos}')
if cdn: print(f'CDN 下载链接: {cdn}')
if not bos and not cdn: print(json.dumps(result, ensure_ascii=False, indent=2))
"
break
elif [ "$STATUS" = "error" ]; then
echo "✗ 查询失败"
echo "$POLL"
break
else
echo "[$i/20] 生成中... (status=$STATUS)"
sleep 15
fi
done
Step 4: 下载视频到工作空间
BOS/CDN 链接有时效性，需尽快下载并上传持久化。下载到当前工作空间：
VIDEO_PATH="./picture_book_$(date +%Y%m%d_%H%M%S).mp4"
curl -L -o "$VIDEO_PATH" "<BOS 下载链接>"
ls -lh "$VIDEO_PATH"
Step 5: 上传到虾聊持久化
百度 BOS/CDN 链接有有效期，上传到虾聊（ClawdChat）获取公网永久链接：
UPLOAD_RESPONSE=$(curl -s -X POST https://clawdchat.ai/api/v1/files/upload \
-H "Authorization: Bearer $CLAWDCHAT_API_KEY" \
-F "file=@$VIDEO_PATH")
PUBLIC_URL=$(echo "$UPLOAD_RESPONSE" | python3 -c "import sys,json; print(json.load(sys.stdin)['url'])" 2>/dev/null)
if [[ -z "$PUBLIC_URL" || "$PUBLIC_URL" != https://* ]]; then
echo "虾聊上传失败，响应：$UPLOAD_RESPONSE"
exit 1
fi
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$PUBLIC_URL")
if [ "$HTTP_CODE" = "200" ]; then
echo "上传成功，永久链接: $PUBLIC_URL"
else
echo "上传验证失败（HTTP $HTTP_CODE），URL：$PUBLIC_URL"
exit 1
fi
验证： 最终返回的 PUBLIC_URL 为永久有效的公网链接，可直接分享或嵌入内容。
完整一键示例
以下是从创建到获取结果、下载并上传虾聊的完整脚本：
python3 -c "
import os, sys, json, time, requests, subprocess
from datetime import datetime
API_KEY = os.getenv('BAIDU_API_KEY')
if not API_KEY:
print('错误: 请设置 BAIDU_API_KEY 环境变量')
sys.exit(1)
BASE = 'https://qianfan.baidubce.com'
HEADERS = {
'Authorization': f'Bearer {API_KEY}',
'Content-Type': 'application/json',
'X-Appbuilder-From': 'openclaw'
}
STORY = '''<在此粘贴故事文本>'''
METHOD = 10 # 9=静态, 10=动态
# 创建任务
resp = requests.post(f'{BASE}/v2/tools/ai_picture_book/task_create',
headers=HEADERS,
json={'method': METHOD, 'input_type': '1', 'input_content': STORY})
resp.raise_for_status()
data = resp.json()
if 'errno' in data and data['errno'] != 0:
print(f'创建失败: {data}')
sys.exit(1)
task_id = data['data']['task_id']
print(f'任务已创建: {task_id}')
# 轮询（15 秒间隔，最多 20 次 = 5 分钟）
video_url = None
for i in range(1, 21):
time.sleep(15)
resp = requests.post(f'{BASE}/v2/tools/ai_picture_book/query',
headers=HEADERS,
json={'task_ids': [task_id]}, timeout=30)
result = resp.json()
tasks = result.get('data', [])
if not tasks:
print(f'[{i}/20] 无数据...')
continue
status = tasks[0].get('status')
if status == 2:
video = tasks[0].get('result', {})
video_url = video.get('video_bos_url') or video.get('video_cdn_url', '')
print('\\n' + '='*50)
print('✓ 绘本生成完成！')
print('='*50)
print(f'视频链接: {video_url}')
break
print(f'[{i}/20] 生成中... (status={status})')
else:
print('\\n超时，任务可能仍在运行，请稍后用 task_id 手动查询')
sys.exit(1)
if not video_url:
print('未获取到视频链接')
sys.exit(1)
# 下载到工作空间
ts = datetime.now().strftime('%Y%m%d_%H%M%S')
local_path = f'./picture_book_{ts}.mp4'
print(f'\\n下载视频到: {local_path}')
r = requests.get(video_url, stream=True, timeout=120)
r.raise_for_status()
with open(local_path, 'wb') as f:
for chunk in r.iter_content(8192):
f.write(chunk)
size_mb = os.path.getsize(local_path) / 1024 / 1024
print(f'下载完成: {size_mb:.1f} MB')
# 上传到虾聊持久化
cred_paths = ['skills/clawdchat/credentials.json', os.path.expanduser('~/.clawdchat/credentials.json')]
claw_key = None
for p in cred_paths:
if os.path.exists(p):
creds = json.load(open(p))
claw_key = creds[0]['api_key'] if isinstance(creds, list) else creds.get('api_key')
break
if claw_key:
print('\\n上传到虾聊...')
with open(local_path, 'rb') as f:
up = requests.post('https://clawdchat.ai/api/v1/files/upload',
headers={'Authorization': f'Bearer {claw_key}'},
files={'file': (os.path.basename(local_path), f, 'video/mp4')}, timeout=120)
pub_url = up.json().get('url', '')
if pub_url.startswith('https://'):
print(f'永久链接: {pub_url}')
else:
print(f'上传失败: {up.text}')
else:
print('\\n未找到虾聊凭证，跳过上传。本地文件: ' + local_path)
"
故事文本技巧
绘本 AI 会自动将故事拆分为多个场景并配图，以下技巧可提升生成质量：
推荐结构：
- 故事长度 200-500 字效果最佳
- 包含 3-6 个场景切换（不同地点/时间/情节转折）
- 角色名称保持一致，便于 AI 维持角色形象
- 加入视觉描写（颜色、天气、表情）帮助 AI 生成更精准的画面
示例故事：
在月光森林里，住着一只怕黑的小刺猬，名叫阿团。每到夜晚，它都把自己缩成一团，不敢出门。一天，森林停电了，萤火虫奶奶邀请阿团一起去点亮夜路。阿团颤抖着跟上队伍，发现每帮助一位迷路的小动物，自己背上的一根小刺就会发出微光。它先送迷路的小兔回家，再帮小松鼠找到丢失的橡果，还陪小鹿跨过小溪。最后，阿团的刺像星星一样亮，整片森林被温柔照亮。
注意：
- 中文故事效果优于英文
- 避免过于抽象的描述，具体场景更易生成高质量画面
- 动态绘本（method=10）对动作描写更敏感，适当加入角色动作
核心参数速查
创建任务 POST /v2/tools/ai_picture_book/task_create
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
method | int | 是 | - | 9 静态绘本，10 动态绘本 |
input_type | string | 是 | - | 固定 "1"（纯文本） |
input_content | string | 是 | - | 故事文本 |
查询任务 POST /v2/tools/ai_picture_book/query
| 参数 | 类型 | 必填 | 说明 |
|---|
task_ids | array | 是 | 任务 ID 数组，支持批量查询 |
响应字段
| 字段 | 说明 |
|---|
status | 任务状态码（见上方状态码表） |
result.video_bos_url | BOS 视频下载链接（永久有效） |
result.video_cdn_url | CDN 加速链接（带鉴权，有时效） |
错误处理
| 错误 | 原因 | 解决 |
|---|
| 401 Unauthorized | API Key 无效或过期 | 检查 BAIDU_API_KEY 格式是否为 bce-v3/ALTAK-xxx/xxx |
errno != 0 | 请求参数错误 | 检查 errmsg 字段获取具体原因 |
| 轮询超时 | 任务耗时过长 | 动态绘本通常 2-3 分钟，可增大轮询次数 |
status 非 0/1/2/3 | 生成失败 | 检查故事文本是否过短或含违规内容 |
无 video_bos_url | 任务未完成即查询 | 确认 status=2 后再提取链接 |
code 字段存在 | 服务端错误 | 查看 detail 字段，通常为鉴权或频率问题 |
