seedream

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 と互換性があります

クイックスタート

手順 1：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

手順 2：最初の画像を生成する

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

API Key の設定方法

方法 1：環境変数で設定する（推奨）

ターミナルで環境変数を設定します。

# 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')

方法 2：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（1 分あたりの画像数）: 500 枚/分（Seedream 4.5、4.0）
• モデルによってレート制限が異なります。詳細は公式ドキュメントをご確認ください

画像の保存期間

⚠️ 重要なお知らせ：

• タスクデータ（画像 URL を含む）の保存期間は 24 時間です
• 期限を過ぎると自動的に削除されます
• 生成された画像は必ず速やかにダウンロードして保存してください

使用例

パスについて：以下の例では、スクリプトのパスを指定するために環境変数 $SKILLS_ROOT を使用します。LobsterAI がこの変数を自動設定し、実際の SKILLs ディレクトリの場所を示すため、パスを手動で変更する必要はありません。

1. テキストから画像を生成（T2I）

テキストの説明に基づいて画像を生成します。アイデアの創出やコンセプトデザインに適しています。

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，景深较浅，Vogue杂志封面美学风格" \
  --output portrait.png

プロンプトの例：

• 「写実的なスタイル。晴れた青空の下に広がる白いヒナギク畑。カメラが徐々に近づき、最後に一輪のヒナギクのクローズアップで止まる」
• 「カートゥーンスタイル。窓辺に座るオレンジ色の子猫。日差しが体に降り注ぎ、温かく癒やされる雰囲気」
• 「サイバーパンクスタイル。未来都市の夜景。ネオンがきらめき、高層ビルが立ち並ぶ」

2. 画像編集（I2I）- 1 枚の画像を入力

既存の画像をもとに、テキストの指示を組み合わせて画像を編集します。ローカル画像とネットワーク上の URL に対応しています。

# 使用本地图片
bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "保持模特姿势不变，将服装材质改为透明玻璃质感" \
  --image "/Users/yourname/Pictures/model.jpg" \
  --output edited_model.png

# 使用网络图片
bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "将背景改为海边日落场景" \
  --image "https://example.com/photo.jpg" \
  --output beach_sunset.png

対応する画像ソース：

• ✅ ローカルファイル：/path/to/image.jpg
• ✅ ネットワーク URL：https://example.com/image.jpg
• ✅ file:// プロトコル：file:///path/to/image.jpg

対応する画像形式：

• jpg、jpeg、png、gif、webp、bmp、tiff、heic

3. 複数画像の融合（複数画像を入力し、1 枚の画像を出力）

複数の参照画像の特徴を融合して新しい画像を生成します。ローカル画像とネットワーク画像を混在させて使用できます。

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "将图1的服装换为图2的服装" \
  --image "/Users/yourname/Pictures/person.jpg" \
  --image "https://example.com/clothes.jpg" \
  --output fusion_result.png

よくある使用例：

• 服の試着：人物画像 + 服の画像 → 着用イメージ
• スタイルの転写：写真 + スタイルの参照画像 → スタイル化された作品
• シーンの融合：人物 + 背景 → 合成シーン

4. シリーズ画像の生成（複数画像を出力）

漫画のコマ割りやブランドビジュアルなどに適した、内容につながりのある画像のセットを生成します。

テキストからシリーズ画像を生成

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "生成一组共4张连贯插画，核心为同一庭院一角的四季变迁，以统一风格展现四季独特色彩、元素与氛围" \
  --sequential \
  --max-images 4 \
  --output seasons.png

出力ファイルには自動的に番号が付けられます：seasons_1.png、seasons_2.png、seasons_3.png、seasons_4.png

1 枚の画像からシリーズ画像を生成

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "参考这个LOGO，做一套户外运动品牌视觉设计，品牌名称为'GREEN'，包括包装袋、帽子、卡片、挂绳等" \
  --image "/Users/yourname/Pictures/logo.png" \
  --sequential \
  --max-images 4 \
  --output brand_design.png

5. ウェブ検索による生成の強化（Seedream 5.0 lite）

リアルタイムのウェブ検索を有効にし、最新のウェブ情報を取り入れます。

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "搜索下近期热门的白鸭子单手拿着风车形象，以极具冲击力的视角，设计成巨型装置" \
  --search \
  --output search_result.png

注意：

• ウェブ検索機能は Seedream 5.0 lite モデルでのみ利用できます
• --search パラメーターを使うと、モデルは自動的に 5.0 lite に切り替わります
• リアルタイム情報を取り入れた創作に適しています

パラメーターの説明

必須パラメーター

パラメーター	説明	例
--prompt	画像の説明プロンプト（必須）	「かわいい子猫」

任意パラメーター

パラメーター	説明	デフォルト値	選択可能な値
--image	参照画像のパスまたは URL（複数回使用可能）	なし	ローカルファイルのパスまたは URL
--model	モデル ID	doubao-seedream-4-5-251128	モデル一覧を参照
--size	画像サイズ	2K	1K、2K、4K
--no-watermark	透かしを追加しない	いいえ	フラグパラメーター
--sequential	シリーズ画像を生成する	いいえ	フラグパラメーター
--max-images	シリーズ画像の枚数	4	1～8
--search	ウェブ検索を有効にする	いいえ	フラグパラメーター
--output	出力ファイルのパス	generated_image.png	ファイルパス
--poll-interval	状態の確認間隔（秒）	5	1～10
--timeout	最大待機時間（秒）	300	60～600

モデルの選択

品質、速度、コストのバランスを考慮して、適切なモデルを選択してください。

Seedream 4.5（推奨）

• モデル ID: doubao-seedream-4-5-251128
• 特徴: 最新バージョンで、総合的な品質が最も優れています
• 対応: テキストから画像を生成、画像から画像を生成、複数画像の融合、シリーズ画像の生成
• 出力: 1K～4K の解像度を選択可能
• レート制限: IPM 500

Seedream 4.0

• モデル ID: doubao-seedream-4-0-250828
• 特徴: 成熟して安定したバージョンです
• 対応: テキストから画像を生成、画像から画像を生成、複数画像の融合、シリーズ画像の生成
• 出力: 1K～4K の解像度を選択可能
• レート制限: IPM 500

Seedream 5.0 lite（ウェブ検索専用）

• モデル ID: doubao-seedream-5-0-260128
• 特徴: ウェブ検索に対応し、リアルタイムのウェブ情報を取り込みます
• 使用方法: --search パラメーターで自動的に有効になります
• 注意: 2026年2月24日18時以降、API が正式に公開されます

推奨する使用場面：

• 最高品質を求める場合 → 4.5
• 安定した本番環境での運用 → 4.0
• リアルタイム情報が必要な場合 → 5.0 lite（--search を使用）

高度なオプション

画像サイズのカスタマイズ

使用場面に応じて適切なサイズを選択します。

# 小尺寸（快速预览）
--size "1K"

# 标准尺寸（推荐）
--size "2K"

# 高清晰度
--size "4K"

注意：

• サイズが大きいほど、生成に時間がかかります
• 4K 画像の生成には 40～60 秒かかる場合があります

透かしの削除

透かしなしの画像を生成します（商用利用向け）。

--no-watermark

ポーリングとタイムアウトの制御

さまざまな使用場面に合わせてポーリング方法を調整します。

# 快速查询（适合小图）
--poll-interval 3 --timeout 180

# 标准配置
--poll-interval 5 --timeout 300

# 耐心等待（适合4K或组图）
--poll-interval 10 --timeout 600

状態の説明

生成中に発生する可能性があるタスクの状態：

状態	説明	操作
queued	タスクはキューで待機中です	待機を続ける
running	画像を生成中です	待機を続ける
succeeded	生成に成功しました	画像をダウンロードする
failed	生成に失敗しました	エラー情報を確認する

エラー処理

常见错误及解决方案

错误：未设置环境变量 ARK_API_KEY

• 原因：未配置 API Key
• 解决：按照"如何配置 API Key"部分的说明进行配置

错误：任务创建失败 (HTTP 401)

• 原因：API Key 无效或已过期
• 解决：检查 API Key 是否正确，或在控制台重新生成

错误：任务创建失败 (HTTP 400)

• 原因：参数错误（如 size 不支持、prompt 为空等）
• 解决：检查参数是否符合要求

错误：任务超时

• 原因：生成时间过长或 API 繁忙
• 解决：增加 --timeout 值，或稍后重试

错误：任务失败

• 原因：内容违规、提示词不清晰、图片格式错误等
• 解决：检查提示词内容，确保图片URL可访问

错误：限流 (HTTP 429)

• 原因：超过 IPM 限制
• 解决：等待1分钟后重试，或升级配额

错误：图片文件不存在

• 原因：本地图片路径错误
• 解决：检查文件路径是否正确，使用绝对路径

输出格式

生成的图片具有以下特征：

• 格式: PNG, JPEG（根据output参数自动识别）
• 分辨率: 1K / 2K / 4K（根据 size 参数）
• 文件大小: 约 0.5-10 MB（取决于尺寸和复杂度）
• 命名规则:
  • 单图：指定的文件名
  • 组图：文件名_1.png, 文件名_2.png, ...

提示词最佳实践

优秀提示词的特点

1. 清晰的主体描述 - 说明画面的主要内容
2. 具体的风格指定 - 写实、卡通、赛博朋克等
3. 细节补充 - 色彩、光线、氛围等
4. 构图说明 - 特写、全景、俯视等视角

提示词模板

[风格]，[主体描述]，[细节补充]，[构图/氛围]

示例：

写实风格，一只橘色小猫坐在木制窗台上，阳光从左侧洒进来，温暖治愈的氛围，特写构图

提示词注意事项

• ✅ 具体描述："小猫在追逐蝴蝶" 而非 "小猫玩耍"
• ✅ 风格说明："赛博朋克风格" 而非 "好看的"
• ✅ 细节丰富："橘色长毛小猫，蓝色眼睛" 而非 "猫"
• ❌ 避免模糊：过于抽象的描述会导致随机性增加
• ❌ 避免过长：保持在 200 字以内效果最佳
• ❌ 避免违规：不要包含暴力、色情等违规内容

常见使用场景

产品设计

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "现代简约风格，智能手表产品展示，白色背景，工作室灯光" \
  --size "4K"

艺术创作

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "超现实主义，漂浮的岛屿，瀑布从天而降，梦幻色彩" \
  --size "2K"

社交媒体内容

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "美食特写，热气腾腾的拉面，筷子夹起面条，暖色调" \
  --size "2K"

品牌视觉设计

bash "$SKILLS_ROOT/seedream/scripts/generate-image.sh" \
  --prompt "参考logo，生成一套完整的品牌视觉系统，包括名片、海报、包装设计" \
  --image brand_logo.png \
  --sequential \
  --max-images 4

参考资料

• API 参考：https://www.volcengine.com/docs/82379/1541523
• 控制台：https://console.volcengine.com/ark
• API Key 管理：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
• 模型列表：https://www.volcengine.com/docs/82379/1330310

技术支持

如遇到问题，可以：

1. 查看脚本输出的错误信息
2. 检查 API Key 配置是否正确
3. 访问火山方舟控制台查看任务详情
4. 参考官网文档了解更多细节