byted-seedream-image-generate

byted-seedream-image-generate

説明

Volcano Engine Seedream モデルを使用して、テキストプロンプトから高品質な画像を生成します。このスキルでは、3 つの強力な Seedream モデルバージョン（4.0、4.5、5.0-lite）を利用できます。それぞれ、用途に応じた独自の機能を備えています。

このスキルを使用する場面

次のような場合に、このスキルを使用してください：

• テキストによる説明から画像を作成したい場合
• さまざまな芸術的スタイルの作品を生成したい場合
• クリエイティブなプロジェクト向けにビジュアルコンテンツを作成したい場合
• AI を活用した画像生成機能が必要な場合
• 参照画像を異なるスタイルに変換したい場合
• 複数の画像を一括生成したい場合
• 高品質でプロフェッショナルな見た目の画像が必要な場合

モデルバージョン

バージョン	モデル名	リリース日	推奨度	最適な用途
4.0	doubao-seedream-4-0-250828	2025年8月	⭐⭐⭐	日常的な使用、素早い生成
4.5	doubao-seedream-4-5-251128	2025年11月	⭐⭐⭐⭐	細部にこだわる作業、複雑なシーン
5.0	doubao-seedream-5-0-260128	2026年	⭐⭐⭐⭐⭐	最高品質、優れた創造性、ツール対応

機能

• テキストから画像を生成：詳細なテキストによる説明から画像を生成します
• 画像から画像へ変換：参照画像を異なるスタイルに変換します
• 一括生成：1 回のリクエストで複数の画像を作成します
• 複数のバージョン：4.0、4.5、5.0-lite モデルから選択できます
• ウォーターマークの制御：ウォーターマークを無効にできます
• カスタムサイズ：さまざまな画像サイズに対応しています
• 出力形式：PNG および JPEG 形式（5.0-lite のみ）
• ウェブ検索ツール：インターネット検索との連携（5.0-lite のみ）

インストールとセットアップ

前提条件

# Required: API Key configuration
export MODEL_IMAGE_API_KEY="your-api-key-here"
# or
export MODEL_AGENT_API_KEY="your-api-key-here"
# or
export ARK_API_KEY="your-api-key-here"

# Optional: API Base URL (default already configured)
export MODEL_IMAGE_API_BASE="https://ark.cn-beijing.volces.com/api/v3"
# or
export ARK_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"

スクリプトでは、次の優先順位で使用します：

1. 環境変数（ARK_API_KEY、MODEL_IMAGE_API_KEY、MODEL_AGENT_API_KEY）
2. 環境変数（ARK_BASE_URL、MODEL_IMAGE_API_BASE）
3. デフォルト値

使用方法

基本的な使い方（5.0-lite バージョンを推奨）

cd scripts
python seedream_image_generate.py -p "A cute kitten playing in a garden"

バージョンを指定する

# Use 4.0 version
python seedream_image_generate.py -p "A cute kitten" --version 4.0

# Use 4.5 version
python seedream_image_generate.py -p "A cute kitten" --version 4.5

# Use 5.0-lite version (recommended)
python seedream_image_generate.py -p "A cute kitten" --version 5.0

高度なオプション

# Custom size without watermark
python seedream_image_generate.py -p "Beautiful sunset" -s 2048x2048 --no-watermark --version 5.0

# Batch generation
python seedream_image_generate.py -p "Generate 3 cute dog pictures" -g --max-images 3 --version 4.5

# Image-to-image
python seedream_image_generate.py -p "Convert this image to anime style" -i "https://example.com/image.jpg" --version 5.0

# Web search tool (5.0-lite only)
python seedream_image_generate.py -p "Latest 2026 smartphone" --web-search --version 5.0

# Custom output format (5.0-lite only)
python seedream_image_generate.py -p "A beautiful landscape" --output-format png --version 5.0

# List all supported versions
python seedream_image_generate.py --list-versions

コマンドラインオプション

オプション	ショートカット	説明	デフォルト
--prompt	-p	画像の説明テキスト（必須）	-
--version	-v	バージョンの選択：4.0、4.5、5.0	5.0
--size	-s	画像サイズ	2048x2048
--image	-i	単一の参照画像 URL	-
--images	-	複数の参照画像 URL（スペース区切り）	-
--group	-g	画像の一括生成を有効にする	false
--max-images	-	一括生成する画像の最大数	15
--output-format	-	出力形式：png または jpeg（5.0 のみ）	jpeg
--response-format	-	レスポンス形式：url または b64_json	url
--stream	-	ストリーミング出力を有効にする	false
--web-search	-	ウェブ検索ツールを有効にする（5.0 のみ）	false
--optimize-prompt-mode	-	プロンプト最適化モード：standard または fast	-
--timeout	-t	タイムアウト（秒）	1200
--no-watermark	-	ウォーターマークを無効にする	false
--list-versions	-	対応するすべてのバージョンを一覧表示する	-

Python API の使用方法

import asyncio
import sys

sys.path.append("scripts")
from seedream_image_generate import seedream_generate

async def main():
    # Use 5.0-lite version (default)
    result = await seedream_generate([
        {
            "prompt": "A cute kitten",
            "size": "2048x2048",
            "watermark": False,
            "output_format": "png"  # 5.0-lite only
        }
    ], version="5.0")
    
    print(result)

asyncio.run(main())

バージョンの選び方

4.0 を選ぶ場合：

• 日常的に素早く画像を生成したい
• 非常に高い品質は必要ない
• より速い生成速度が必要
• シンプルなシーンやスタイルを扱う

4.5 を選ぶ場合：

• より豊かなディテールを求める
• 複雑なシーンを扱う
• スタイルをより忠実に再現したい
• 中程度の品質要件がある

5.0-lite（推奨）を選ぶ場合：

• 最高品質を求める
• 革新的な創造表現が必要
• 非常に細部にこだわる
• ツールパラメーター（ウェブ検索など）が必要 ⭐
• カスタム出力形式（png/jpeg）が必要 ⭐
• 重要なプロジェクトや業務に使用する

迷ったら、5.0-lite を使用してください！ ⭐

プロンプト作成のヒント

基本的なプロンプトの構成

[Subject Description] + [Style/Art Movement] + [Lighting/Atmosphere] + [Quality/Resolution]

高度なプロンプト（5.0-lite 向けに最適化）

[Subject Description], [Creative Style/Art Movement], [Unique Perspective/Composition], [Special Lighting/Atmosphere], [Emphasizing 5.0-lite creative expression]

バージョンごとのパラメーター対応状況

パラメーター	Seedream 4.0	Seedream 4.5	Seedream 5.0-lite	説明
model	✅	✅	✅	モデル名
prompt	✅	✅	✅	プロンプト（必須）
image	✅	✅	✅	参照画像
size	✅	✅	✅	画像サイズ
sequential_image_generation	✅	✅	✅	バッチ生成の制御
sequential_image_generation_options	✅	✅	✅	バッチ生成の設定
response_format	✅	✅	✅	レスポンス形式（url/b64_json）
watermark	✅	✅	✅	透かし（true/false）
stream	✅	✅	✅	ストリーミング出力
optimize_prompt_options	✅	✅	✅	プロンプト最適化の設定
tools	❌	❌	✅	ツール設定（5.0-lite のみ）
output_format	❌	❌	✅	出力形式（png/jpeg、5.0-lite のみ）

最終的な返却情報

OpenClaw の場合

1. まず、生成した画像を許可されたディレクトリに保存／ダウンロードします：

   • 推奨：~/.openclaw/workspace/

2. message tool を使って、次のパラメーターで画像を送信します：

   {
     "action": "send",
     "message": "Optional text description",
     "media": "/root/.openclaw/workspace/generated-image.jpg"
   }
   

   • このツールは自動的に、ローカルファイルを読み込み、チャンネルサーバーに Web URL としてアップロードし、画像メッセージとして送信します。

3. 送信成功を確認します：ツールが {"ok": true} を返すことを確認してください。画像が正常に送信されたことを示します。

4. 通常のテキストで返す場合（message tool を使わない場合）：生成後、次のような Markdown 形式で画像の一覧を表示します： 特に重要： 画像 URL は https:// で始まる元のオンラインリソースへのリンクでなければなりません。ダウンロードしたローカル画像のアドレスは使用しないでください。

通常の場合

次の 3 種類の情報を返してください：

1. ファイル形式、画像ファイル（画像ファイルを送信する他の方法がある場合）と画像のローカルパス。例： local_path: /root/.openclaw/workspace/skills/image-generate/xxx.png
2. 生成後、次のような Markdown 形式で画像の一覧を表示します：

      ![generated-image-1](https://example.com/image1.png)
      ![generated-image-2](https://example.com/image2.png)

よくある質問

Q：各バージョンの違いは何ですか？

A：4.0 は日常的な用途でのすばやい生成向け、4.5 は複雑なシーンの描写においてより優れた詳細表現を提供し、5.0-lite は独自のツール対応とともに最高品質を実現します。

Q：生成された URL の有効期間はどのくらいですか？

A：URL は 24 時間有効です。画像は速やかにダウンロードして保存してください。

Q：参照画像で対応している形式は何ですか？

A：JPG や PNG などの一般的な形式に対応しており、URL または Base64 で指定できます。

Q：1 回の呼び出しで複数のバージョンを使用できますか？

A：現在、1 回の呼び出しで使用できるバージョンは 1 つだけです。比較する場合は、バージョンごとに別々に呼び出してください。

ライセンス

このスキルは Apache License 2.0 の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

注意事項

このスキルを使用する際は、Volcano Engine の利用規約および関連する法令を遵守してください。