Seedream（豆包）シリーズ
ByteDance の豆包画像モデルで、全 3 モデルです。OpenAI 互換エンドポイント /v1/images/generations で呼び出し、テキストからの画像生成と画像編集のどちらもこのエンドポイントを使います。
モデルの選び方
- 1K サイズに対応
- 組画像と 4k プリセットには非対応
- 組画像と 4K に対応
- 最小 2K
- 組画像と n による複数枚生成に対応
- 最小 2K
volcengine/doubao-seedream-5.0-proフラッグシップ、1K に対応リアルタイム価格はモデルページ を参照してください。
テキストから画像生成
Python
import base64
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
resp = client.images.generate(
model="volcengine/doubao-seedream-5.0-pro",
prompt="白いテーブルの上に置かれた赤いリンゴ",
size="2560x1440",
)
with open("output.jpg", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))出力形式は JPEG 固定のため、保存時は拡張子 .jpg を使ってください。デフォルトでは base64 で返ります。"response_format": "url" を指定すると画像の URL で返ります。
サイズ（size）
1k も 1024×1024 も拒否されます。size には 2 通りの書き方があります：
- 解像度プリセット
1k、2k、4k（大文字・小文字を区別しない）：解像度のみを指定し、アスペクト比はプロンプトに応じてモデルが決定します。実測では 4.5 に2kを指定すると、2048×2048 と 1664×2496 のどちらも出力されました。 - 正確な幅と高さ
幅x高さ：アスペクト比が固定されます。下表のピクセル範囲を満たす必要があります。
「—」は今回未検証であることを示します。Volcano Engine Ark（火山方舟）公式ドキュメント を参照してください。
よく使う有効な幅と高さ（4.5 と 5.0 Lite の最小ピクセル数を満たすもの）：
画像編集と複数画像の参照
input_images ではなく image フィールドを使います。/v1/images/edits には対応していません。Python
import base64
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
with open("apple.jpg", "rb") as f:
ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
resp = client.images.generate(
model="volcengine/doubao-seedream-5.0-pro",
prompt="リンゴを紫色に変え、それ以外はそのままにする",
size="2k",
extra_body={"image": [ref]},
)
with open("apple_purple.jpg", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))imageは配列で、各要素は画像の URL またはdata:image/...;base64,で始まる文字列です。複数の参照画像は順に配列に入れ、プロンプトで各画像の役割を説明してください。input_imagesは Qwen-Image 専用のフィールドで、Seedream は非対応です。- Seedream は
/v1/images/editsに対応していません。画像編集にはこのセクションのimageフィールドを使ってください。
組画像と複数枚
組画像の例：
{
"model": "volcengine/doubao-seedream-5.0-lite",
"prompt": "独立した画像を 3 枚生成：同じキツネが春、夏、秋にいる様子",
"size": "2k",
"sequential_image_generation": "auto",
"sequential_image_generation_options": { "max_images": 3 }
}autoは生成枚数をモデルが決定することを意味し、max_imagesは上限にすぎません。実測では同じリクエストで 4.5 は 3 コマ漫画を 1 枚の画像にまとめ、1 枚のみを返しました。枚数を固定したい場合は、プロンプトに「独立した画像を N 枚生成」と明記してください。- 画像は 1 枚ごとに課金され、
usage.output_tokensはすべての画像の合計です。
透かし
実測では、OfoxAI 経由で呼び出した場合はデフォルトで透かしは入りません。追加のパラメーターは不要です。
所要時間
実測では 2K で約 12〜40 秒、3 枚の組画像で約 76 秒でした。クライアントのタイムアウトは 300 秒以上に設定することを推奨します。
よくあるエラー
エラーメッセージ末尾の Request id: 0217… は上流のリクエスト番号です。サポートに問い合わせる際は、レスポンスの request_id と併せてお知らせください。
エラーメッセージの原文
The parameter `size` specified in the request is not valid: image size must be at least 3686400 pixels.
The parameter `size` specified in the request are not valid: image area must be at least 921600 pixels.
The parameter `size` specified in the request is not valid: image size must be at most 16777216 pixels.
The parameter `size` specified in the request is not valid: the specified size is not supported for model doubao-seedream-4-5.
The parameter `size` specified in the request are not valid: must be 'WIDTHxHEIGHT' or a supported size preset.
The parameter `size` specified in the request is not valid: size must be one of 'WIDTHxHEIGHT', '1k', '2k', or '4k'.
The parameter `sequential_image_generation` specified in the request are not valid: the parameter `sequential_image_generation` is not supported by the current model.
The parameter `output_format` specified in the request is not valid: the parameter `output_format` is not supported by the current model.公式ドキュメント
公式ドキュメントは Volcano Engine Ark（火山方舟）に直接リクエストした場合の動作を説明しています。OfoxAI 経由で呼び出す場合は、このページの実測結果を優先してください。
よくある質問
Seedream で image size must be at least 3686400 pixels エラーが出た場合はどうすればよいですか？
Seedream 4.5 と 5.0 Lite の最小サイズは 2K（3,686,400 ピクセル）で、1024x1024 も 1k も要件を満たしません。2k、または 2048x2048、2560x1440、1440x2560 などの幅と高さに変更してください。小さいサイズが必要な場合は 5.0 Pro を使ってください。最小 921,600 ピクセル（1280x720）で、1k にも対応しています。
Seedream で画像を編集するには？ input_images を使っても効果がないのはなぜですか？
Seedream の参照画像フィールドは input_images ではなく image（配列。各要素は画像の URL または data:image で始まる base64）です。input_images は Qwen-Image 用のフィールドです。また、Seedream は /v1/images/edits に対応していないため、画像編集にも /v1/images/generations を使います。
Seedream の組画像で 1 回に複数枚を生成するには？
sequential_image_generation: "auto" と sequential_image_generation_options.max_images を指定します。auto は枚数をモデルが決定することを意味し、max_images は上限です。プロンプトに「独立した画像を N 枚生成」と明記するとより安定します。5.0 Lite と 4.5 は対応しており、5.0 Pro は非対応です。
Seedream 5.0 Pro に n を指定すると sequential_image_generation is not supported が返るのはなぜですか？
5.0 Pro は 1 回で複数枚を生成することに対応しておらず、n も組画像のパラメーターもこのエラーを返します。n を削除し、複数枚が必要な場合はリクエストを並行して複数回送信してください。
Seedream で生成した画像に透かしは入りますか？
OfoxAI 経由で呼び出した場合、実測ではデフォルトで透かしは入りません。追加のパラメーターは不要です。
Seedream は PNG で出力できますか？
できません。出力は JPEG 固定です。output_format を指定すると 400 が返るため、このパラメーターを削除してください。
Seedream の size に 2k を指定するとアスペクト比が一定にならないのはなぜですか？
1k、2k、4k は解像度のみを指定し、アスペクト比はプロンプトに応じてモデルが決定します。アスペクト比を固定したい場合は、2560x1440 のように正確な幅と高さを指定してください。