Doubao Media / 豆包媒体生成

中文: 豆包（字节跳动火山引擎ARK）文生图、文生视频工具。生成后自动发送到对话，无需手动查找文件。
English: Doubao (ByteDance Volcengine ARK) text-to-image and text-to-video tool. Auto-sends generated content to chat, no manual file search needed.

---

Features / 功能特点

Feature	中文	English
Text-to-Image	✅ 文生图	✅ Generate images from text
Text-to-Video

✅ 文生视频 | ✅ Generate videos from text | | Image-to-Video | ✅ 图生视频 | ✅ Generate videos from images | | Auto-Send to Chat | ✅ 自动发送到对话 | ✅ Auto-send to conversation | | Windows Compatible | ✅ Windows 兼容 | ✅ Windows compatible |

---

Prerequisites / 前置条件

Required / 必需

• - ARKAPIKEY - 从控制台获取: https://console.volcengine.com/ark
• Python 3.8+ 并安装 requests 库

Install Dependencies / 安装依赖

bash
pip install requests

Set API Key / 设置 API Key

bash

Windows PowerShell

$env:ARKAPIKEY=yourapikey_here

Linux/Mac

export ARKAPIKEY=yourapikey_here

---

Usage / 使用方法

Generate Image / 生成图片

bash
python scripts/doubao_media.py img 一只可爱的橘猫在阳光下睡觉

Result / 结果:

• - Image saved to output/ directory / 图片保存到 output/ 目录
• Auto-sent to chat / 自动发送到对话

Generate Video / 生成视频

bash

Sync mode (wait for completion) / 同步模式（等待完成）

python scripts/doubao_media.py vid 一只猫在草地上奔跑 --duration 5

Async mode (return task ID) / 异步模式（返回任务ID）

python scripts/doubao_media.py vid 一只猫在草地上奔跑 --async

Generate Video from Image / 图生视频

bash
python scripts/doubao_media.py vid 让这只猫动起来 --image https://example.com/cat.jpg

Check Video Status / 检查视频状态

bash
python scripts/doubaomedia.py status taskxxxxx

---

Parameters / 参数说明

Image Generation / 图片生成

参数	默认值	说明
prompt	必需	文本描述
--size

1024x1024 | 图片尺寸: 1024x1024, 1024x1536, 1536x1024 |

Video Generation / 视频生成

参数	默认值	说明
prompt	必需	文本描述
--duration

5 | 时长（秒），范围2-12 | | --ratio | 16:9 | 宽高比: 16:9, 4:3, 1:1, 9:16 | | --image | 无 | 图生视频的图片URL | | --async | False | 异步模式 |

---

Available Models / 可用模型

模型ID	功能	说明
doubao-seedream-3-0-t2i-250415	文生图	从文本生成图片
doubao-seedance-1-0-pro-250528

文生视频 | 从文本或图片生成视频 |

---

Output / 输出

生成的文件保存到:

~/.openclaw/workspace/output/
├── imgYYYYMMDDHHMMSS.jpeg # 图片
└── vidYYYYMMDDHHMMSS.mp4 # 视频

---

Performance / 性能指标

操作	时间	说明
文生图	10-30秒	取决于复杂度
文生视频

1-3分钟 | 5秒视频 |

---

Troubleshooting / 故障排除

Error: ARKAPIKEY not set

解决方案:
bash
$env:ARKAPIKEY=yourapikey # Windows
export ARKAPIKEY=yourapikey # Linux/Mac

Error: InvalidEndpointOrModel.NotFound

解决方案:
前往火山引擎控制台 → 模型管理，开通所需模型。

需要开通的模型:

• - Doubao-SeeDream-3.0-T2I (文生图)
• Doubao-Seedance-1.0-Pro (文生视频)

Error: UnicodeEncodeError (Windows)

解决方案:
脚本已通过 PYTHONIOENCODING=utf-8 自动处理此问题。

---

Security / 安全

• - 永远不要硬编码 API Key
• 使用环境变量存储敏感信息
• 定期轮换 API Key

---

References / 参考资源

• - 火山方舟文档
• 豆包模型计费

---

版本: 1.0.0 最后更新: 2026-03-29