即梦AI 文生图/文生视频 Skill
基于火山引擎即梦AI的文生图和文生视频能力，支持通过文本描述生成图片和视频。
功能特性
- - 执行过程存储：使用 MD5(提示词) 作为文件夹名保存任务状态
- 异步查询：支持断点续传，避免重复提交相同任务
- Base64 图片处理：直接从 API 响应中解码并保存图片
- 支持即梦AI文生图（v3.0 / v3.1 / v4.0）
- 支持即梦AI文生视频（v3.0 1080P）
- 可配置宽高比、生成数量、自定义尺寸
所需环境变量
| 变量名 | 是否必需 | 说明 |
|---|
| INLINECODE0 | 必需 | 火山引擎 Access Key |
| INLINECODE1 |
条件必需 | 火山引擎 Secret Key（永久凭证必需） |
|
VOLCENGINE_TOKEN | 可选 | 安全令牌（临时凭证 STS 必需） |
注意：使用临时凭证（AKTP 开头）时，可以只使用 AK + Token，不需要 SK。
配置示例
CODEBLOCK0
获取方式：
- 1. 登录 火山引擎控制台
- 进入"访问控制" -> "密钥管理"
- 创建或查看已有访问密钥
安装依赖
CODEBLOCK1
工作流程
首次执行（新任务）
使用新提示词运行时，脚本将：
- 1. 向 API 提交任务
- 使用
md5(提示词) 作为文件夹名创建目录 - 保存
param.json、response.json 和 INLINECODE6 - 输出： INLINECODE7
CODEBLOCK2
后续执行（异步查询）
使用相同提示词运行将查询已有任务：
- 1. 如果图片已存在 → 立即返回图片路径
- 如果任务未完成 → 输出： INLINECODE8
- 如果任务已完成 → 从
binary_data_base64 解码并保存图片
CODEBLOCK3
使用方法
基础用法
CODEBLOCK4
完整参数
CODEBLOCK5
参数说明
| 参数 | 说明 | 默认值 |
|---|
| INLINECODE10 | 图片生成提示词（必填） | - |
| INLINECODE11 |
API版本:
v30,
v31,
v40 |
v31 |
|
--ratio | 宽高比:
1:1,
9:16,
16:9,
3:4,
4:3,
2:3,
3:2,
1:2,
2:1 |
16:9 |
|
--count | 生成数量 1-4 |
1 |
|
--width | 指定宽度（可选） | - |
|
--height | 指定高度（可选） | - |
|
--size | 指定面积（可选，如 4194304 表示 2048x2048） | - |
|
--seed | 随机种子（可选） | - |
|
--output | 图片输出目录 |
./output |
|
--debug | 调试模式 |
false |
|
--no-download | 不下载图片，只返回URL |
false |
输出格式
任务已提交（首次运行）
CODEBLOCK6
任务已完成
CODEBLOCK7
任务未完成
CODEBLOCK8
错误响应
CODEBLOCK9
文件夹结构
CODEBLOCK10
示例
生成风景画
CODEBLOCK11
生成科幻城市
CODEBLOCK12
指定尺寸生成
CODEBLOCK13
自定义输出目录
CODEBLOCK14
版本说明
- - v30: 即梦3.0 基础版本
- v31: 即梦3.1 改进版本
- v40: 即梦4.0 最新版本（推荐）
文生视频使用方法
基础用法
CODEBLOCK15
完整参数
CODEBLOCK16
参数说明
| 参数 | 说明 | 默认值 |
|---|
| INLINECODE39 | 视频生成提示词（必填） | - |
| INLINECODE40 |
宽高比:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9 |
9:16 |
|
--duration | 视频时长:
5 或
10 秒 |
5 |
|
--fps | 帧率:
24 或
30 |
24 |
|
--output | 视频输出目录 |
./output |
|
--wait | 等待任务完成 |
false |
|
--debug | 调试模式 |
false |
|
--no-download | 不下载视频，只返回URL |
false |
视频输出格式
任务已提交
CODEBLOCK17
任务已完成
CODEBLOCK18
任务未完成
CODEBLOCK19
视频文件夹结构
CODEBLOCK20
参考文档
即梦AI 文生图/文生视频 Skill
基于火山引擎即梦AI的文生图和文生视频能力，支持通过文本描述生成图片和视频。
功能特性
- - 执行过程存储：使用 MD5(提示词) 作为文件夹名保存任务状态
- 异步查询：支持断点续传，避免重复提交相同任务
- Base64 图片处理：直接从 API 响应中解码并保存图片
- 支持即梦AI文生图（v3.0 / v3.1 / v4.0）
- 支持即梦AI文生视频（v3.0 1080P）
- 可配置宽高比、生成数量、自定义尺寸
所需环境变量
| 变量名 | 是否必需 | 说明 |
|---|
| VOLCENGINEAK | 必需 | 火山引擎 Access Key |
| VOLCENGINESK |
条件必需 | 火山引擎 Secret Key（永久凭证必需） |
| VOLCENGINE_TOKEN | 可选 | 安全令牌（临时凭证 STS 必需） |
注意：使用临时凭证（AKTP 开头）时，可以只使用 AK + Token，不需要 SK。
配置示例
bash
export VOLCENGINE_AK=your-access-key
export VOLCENGINE_SK=your-secret-key
如果使用临时凭证(STS)，还需要设置 Token
export VOLCENGINE_TOKEN=your-security-token
获取方式：
- 1. 登录 火山引擎控制台
- 进入访问控制 -> 密钥管理
- 创建或查看已有访问密钥
安装依赖
bash
cd ~/.openclaw/workspace/skills/jimeng-ai
npm install
工作流程
首次执行（新任务）
使用新提示词运行时，脚本将：
- 1. 向 API 提交任务
- 使用 md5(提示词) 作为文件夹名创建目录
- 保存 param.json、response.json 和 taskId.txt
- 输出：任务已提交，TaskId: xxx
bash
$ npx ts-node scripts/text2image.ts 一只可爱的猫咪
任务已提交，TaskId: 1234567890
后续执行（异步查询）
使用相同提示词运行将查询已有任务：
- 1. 如果图片已存在 → 立即返回图片路径
- 如果任务未完成 → 输出：任务未完成，TaskId: xxx
- 如果任务已完成 → 从 binarydatabase64 解码并保存图片
bash
$ npx ts-node scripts/text2image.ts 一只可爱的猫咪
任务未完成，TaskId: 1234567890
或者任务完成时：
$ npx ts-node scripts/text2image.ts 一只可爱的猫咪
任务已完成，图片保存路径：
- ./output/
/1.jpg
- ./output//2.jpg
使用方法
基础用法
bash
npx ts-node scripts/text2image.ts 一只可爱的猫咪
完整参数
bash
npx ts-node scripts/text2image.ts 提示词 \
--version v40 \
--ratio 16:9 \
--count 2
参数说明
| 参数 | 说明 | 默认值 |
|---|
| prompt | 图片生成提示词（必填） | - |
| --version |
API版本: v30, v31, v40 | v31 |
| --ratio | 宽高比: 1:1, 9:16, 16:9, 3:4, 4:3, 2:3, 3:2, 1:2, 2:1 | 16:9 |
| --count | 生成数量 1-4 | 1 |
| --width | 指定宽度（可选） | - |
| --height | 指定高度（可选） | - |
| --size | 指定面积（可选，如 4194304 表示 2048x2048） | - |
| --seed | 随机种子（可选） | - |
| --output | 图片输出目录 | ./output |
| --debug | 调试模式 | false |
| --no-download | 不下载图片，只返回URL | false |
输出格式
任务已提交（首次运行）
json
{
success: true,
submitted: true,
prompt: 一只可爱的猫咪,
version: v40,
ratio: 1:1,
count: 1,
taskId: 1234567890,
folder: ./output/,
message: 任务已提交，请稍后使用相同提示词查询结果
}
任务已完成
json
{
success: true,
prompt: 一只可爱的猫咪,
version: v40,
ratio: 1:1,
count: 1,
taskId: 1234567890,
images: [
./output//1.jpg,
./output//2.jpg
],
outputDir: ./output/
}
任务未完成
json
{
success: true,
prompt: 一只可爱的猫咪,
version: v40,
ratio: 1:1,
count: 1,
taskId: 1234567890,
folder: ./output/,
message: 任务未完成，请稍后使用相同提示词查询结果
}
错误响应
json
{
success: false,
error: {
code: MISSING_CREDENTIALS,
message: 请设置环境变量 VOLCENGINEAK 和 VOLCENGINESK
}
}
文件夹结构
output/
└── / # md5哈希作为文件夹名
├── param.json # 请求参数
├── response.json # API提交响应
├── taskId.txt # 任务ID
└── 1.jpg, 2.jpg, ... # 生成的图片
示例
生成风景画
bash
npx ts-node scripts/text2image.ts 山水风景画，水墨风格 --version v40 --ratio 16:9
生成科幻城市
bash
npx ts-node scripts/text2image.ts 未来科幻城市，霓虹灯光，赛博朋克风格 --version v40 --ratio 16:9 --count 2
指定尺寸生成
bash
npx ts-node scripts/text2image.ts 抽象艺术 --width 2048 --height 1152
自定义输出目录
bash
npx ts-node scripts/text2image.ts 一只可爱的猫咪 --output ~/Pictures/jimeng
版本说明
- - v30: 即梦3.0 基础版本
- v31: 即梦3.1 改进版本
- v40: 即梦4.0 最新版本（推荐）
文生视频使用方法
基础用法
bash
npx ts-node scripts/text2video.ts 一只可爱的猫咪在草地上奔跑
完整参数
bash
npx ts-node scripts/text2video.ts 提示词 \
--ratio 9:16 \
--duration 5 \
--fps 24
参数说明
| 参数 | 说明 | 默认值 |
|---|
| prompt | 视频生成提示词（必填） | - |
| --ratio |
宽高比: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | 9:16 |
| --duration | 视频时长: 5 或 10 秒 | 5 |
| --fps | 帧率: 24 或 30 | 24 |
| --output | 视频输出目录 | ./output |
| --wait | 等待任务完成 | false |
| --debug | 调试模式 | false |
| --no-download | 不下载视频，只返回URL | false |
视频输出格式
任务已提交
json
{
success: true,
