Seedream 图片生成

使用火山引擎 Seedream 模型生成高质量 AI 图片，支持文本生成图片（T2I）、图片编辑（I2I）、多图融合、组图生成、联网搜索等多种创作模式。

✨ Node.js 版本：此脚本使用 Node.js 实现，无需 Python 环境。通过入口脚本自动检测 Node.js 运行时（优先使用系统 node，回退到 LobsterAI 内置运行时），Windows 和 Mac 用户都可以开箱即用。

配置

• Base URL: https://ark.cn-beijing.volces.com/api/v3
• API Key: 从环境变量 ARK_API_KEY 读取
• 认证方式: Authorization: Bearer {API_KEY}
• SDK: 兼容火山方舟 Python SDK

快速开始

第一步：设置 API Key

# macOS / Linux - 当前终端临时生效（立即使用）
export ARK_API_KEY="你的API密钥"

# Windows PowerShell - 当前会话临时生效
$env:ARK_API_KEY="你的API密钥"

# 验证设置成功（macOS/Linux）
echo $ARK_API_KEY

# 验证设置成功（Windows）
echo $env:ARK_API_KEY

第二步：生成你的第一张图片

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "一只可爱的橘色小猫"

如何配置 API Key

方式一：通过环境变量配置（推荐）

在终端中设置环境变量：

# macOS/Linux
export ARK_API_KEY="你的API密钥"

# 或者添加到 ~/.zshrc 或 ~/.bashrc 以永久生效
echo 'export ARK_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:ARK_API_KEY="你的API密钥"

# 或者设置系统环境变量以永久生效
[System.Environment]::SetEnvironmentVariable('ARK_API_KEY', '你的API密钥', 'User')

方式二：通过 LobsterAI 启动时注入

LobsterAI 会自动读取系统环境变量，确保在启动 LobsterAI 前已设置 ARK_API_KEY。

如何获取 API Key：

1. 访问火山方舟控制台：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
2. 创建新的 API Key
3. 复制密钥并设置为环境变量

前置检查

无需安装任何依赖！ 该脚本已兼容 Node.js 内置模块。

LobsterAI 已包含 Node.js 运行时，所有必要的依赖已被自动打包。Windows 和 Mac 用户无需额外配置。

工作流程

Seedream 图片生成采用同步模式，流程简单高效：

1. 提交请求 - 调用 API 提交图片生成请求
2. 等待生成 - API 直接处理并生成图片（通常 30-60 秒）
3. 下载图片 - 从返回的 URL 下载生成的图片文件

相比异步模式，同步模式更简单直接，无需轮询任务状态。

配额和限制

免费额度

所有 Seedream 模型提供免费额度，具体请参见火山方舟控制台。

限流限制

• IPM（每分钟图片数）: 500 张/分钟（Seedream 4.5, 4.0）
• 不同模型的限流不同，请参见官方文档

图片保存时间

⚠️ 重要提醒：

• 任务数据（包括图片URL）仅保留 24 小时
• 超时后会被自动清除
• 务必及时下载保存生成的图片

使用示例

路径说明：下面的示例使用 $SKILLS_ROOT 环境变量来引用脚本路径。LobsterAI 会自动设置这个变量，指向实际的 SKILLs 目录位置，因此无需手动修改路径。

1. 文本生成图片（T2I）