Seedream 画像生成と編集 - API易文档中心

概要

Seedream は、ByteDance BytePlus ModelArk のフラグシップ画像生成モデルシリーズであり、生成と編集を統合したアーキテクチャを備えています。Text-to-Image、単一画像編集、複数画像融合、そしてバッチシーケンス生成のすべてが、パラメータの違いのみで単一の /v1/images/generations エンドポイントを通じて実行されます。APIYI は BytePlus と戦略的パートナーシップを結んでおり、提供中のすべてのバージョンを初日から統合しています。

🎨 ハイライト: 新登場の 5.0 Flash は 1リクエストあたり $0.018 で、約15〜20秒で返答します。大量のアセット制作向けに強力なレイアウトとテキストレンダリングを備えています。シリーズ全体で単一の統合 + 4K出力 + 融合用の参照画像最大10枚 + バッチ（入力 + 出力 ≤ 15） + 業界をリードするテキストレンダリングを共有しています。Eコマースのメインビジュアル、広告ポスター、商品写真、コンテンツ制作に最適です — 高品質さと可読性のあるテキストが重視されるあらゆる場面で活躍します。

すべての画像 API は同期型です — ポーリング用のタスクIDは存在せず、クライアントが切断された場合、リクエストに対して課金が発生したまま結果が失われます。このモデルには十分なタイムアウト値を設定してください。詳細については画像 API の基本とベストプラクティスを参照してください。

これはどの Seedream ですか？ APIYI は、中国本土の Doubao / Volcengine 版ではなく、公式の海外 BytePlus（国際）リソース上で Seedream を提供しています。国際版は国内版と比較してコンテンツモデレーションポリシーが比較的緩やかであり、より高い創造的自由度が得られます — これは本プラットフォームの大きな強みですが、モデレーションが完全に存在しないという意味ではありません。BytePlus は引き続き組み込みのコンテンツ安全チェックを実行しており、規約に違反する prompt や参照画像は 400/403 で拒絶されます（拒絶されたリクエストには課金されません）。コンプライアンスを遵守してご利用ください。

Text-to-Image API

POST /v1/images/generations。1K / 2K / 3K / 4K または正確なピクセルサイズで prompt から画像を生成します。

画像編集 API

image パラメータを持つ同一のエンドポイント。単一画像編集、複数画像融合、およびバッチシーケンス（最大15枚の画像）。

過去のバージョン

5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0 の仕様比較、価格の違い、移行ガイド。

AIエージェントに統合を任せる

この prompt をコピーして Codex / Claude Code / Cursor に貼り付けてください

まずこのページのプレーンテキスト版を取得し（任意のドキュメント URL に .md を付加）、プロジェクト固有のスタックでコードを記述します。タイムアウト、URL 結果の即時再ホスト、multipart ではなく URL 配列による編集、seedream-5-0-pro が拒否するパラメータなどは、すでに要件に組み込まれています。

このプロジェクトに Seedream のテキストからの画像生成および画像編集を統合 / トラブルシューティングしてください。

コードに触れる前にドキュメントを読んでください：このページのプレーンテキスト版を取得するには https://docs.apiyi.com/en/api-capabilities/seedream-image/overview.md を fetch してください。より詳細なパラメータについては、… に .md を付加してください

タイムアウト：モデルごとにクライアントのタイムアウトを階層化してください — 4.x シリーズおよび seedream-5-0-flash では60秒から開始し（Flash は10枚の参照画像で約30秒かかります …

合計7つの要件があります。以下のボタンを使用して完全な prompt をコピーしてください。

この prompt によって回避できる落とし穴

要件	回避できる落とし穴
編集に multipart を使用しない	Seedream には `/v1/images/edits` がありません。参照画像は JSON の URL 配列であるため、OpenAI 形式の multipart によるアプローチは完全に失敗します
サーバー側で直ちに再ホストする	アップストリームのリンクは約24時間で期限切れになるため、長期保存すると徐々に 404 エラーが発生します
モデルごとにタイムアウトを階層化する	`seedream-5-0-pro` は約2分かかるため、60秒のタイムアウトでは頻繁に切断が発生します — しかも切断されたリクエストも課金されます。画像 API の基本とベストプラクティスを参照してください
`5-0-pro` / `5-0-flash` で禁止されている2つのフィールド	`sequential_image_generation` は `"disabled"` に設定されていても 400 を返します — 別のバージョンから移植する際に最も陥りやすい罠です
`n` に依存しない	暗黙的に無視され、依然として1枚の画像のみが生成されます。代わりに `sequential_image_generation` を使用してください
`watermark` に false を設定して送信する	デフォルト値はバージョンによって異なるため、商用出力に透かしが入る可能性があります

APIYIのSeedreamが選ばれる理由

BytePlus ModelArk公式チャネルのドロップインリプレイスとして機能し、安定性、コスト、統合の3つの軸で本番環境向けに最適化されています：

戦略的パートナーシップ・安定したリソース

BytePlus ModelArkへの公認直接接続です。リクエストとレスポンスの挙動はアップストリームと同一であり、プロトコルのバイパスはありません。本番環境でも安全にご利用いただけます。

無制限の同時実行数・エンタープライズ対応

バッチ生成、複数画像合成、シーケンス生成向けに線形スケーリングが可能で、Tier形式のアカウント制限はありません。デフォルトで500 RPMに対応しており、より高いクォータが必要な場合は営業担当までお問い合わせください。

同等価格＋チャージで最大20%オフ

デフォルトの単価はBytePlusの公式価格と同等です。チャージボーナスと組み合わせることで、実質価格は定価の80%にまで下がります（5.0 Flashの場合、公式レートを約9%〜17%下回ります）。

グローバルでフリクションレスなアクセス

海外サーバーやプロキシは不要です。中国本土のデータセンター、家庭用ネットワーク、海外ノードからapi.apiyi.comへ直接接続できます。BytePlusのap-southeast-1 / eu-west-1リージョン向けにルーティングを設定する必要はありません。

OpenAI互換・コード変更不要

パス/v1/images/generationsはOpenAIと同一です。OpenAI SDKのbase_urlをAPIYIに向けるだけで、そのままAPIを呼び出せます。拡張パラメータ（image / sequential_image_generationなど）はextra_body経由で渡します。なお、OpenAIのnパラメータはアップストリームでサポートされていません（暗黙的に無視され、画像は1枚のみ出力されます）。複数画像を出力する場合はsequential_image_generationを使用してください。

プロフェッショナルサポート・エンタープライズコンシェルジュ

複数画像合成、テキストレンダリング、アセットの一括バッチ生成など、画像生成ユースケースにおける深い専門知識を備えています。PoCから本番運用へのロールアウトまでエンドツーエンドでサポートします。

主な機能

高精細な4K出力

4.0 / 4.5はネイティブ4K（4096×4096）に対応し、豊かなディテールを表現できます。ポスターや印刷に最適です。5.0-liteは最大3Kですが、全体的にさらに洗練された体験を提供します。

生成と編集を統合

テキストからの画像生成、単一画像の編集、複数画像の融合、バッチ連続生成を、単一のエンドポイントと1組のパラメータで利用できます。imageとsequential_image_generationでモードを切り替えます。

最大10枚の参照画像を融合

imageはURL配列を受け付けます。順序を明示するには、promptで「画像1 / 画像2」のように指定してください。被写体の一貫性を保った融合にはsequential_image_generation: "disabled"を組み合わせます。

テキスト描画の飛躍的な進歩

4.5のリリースでは、小さな文字の読みやすさが大幅に向上しました。ポスター、広告コピー、商品テキストを明瞭かつ正確に描画でき、クラス最高水準です。

最大15枚のバッチ連続生成

sequential_image_generation: "auto"とmax_imagesを組み合わせると、一貫性のあるシリーズを出力できます。ストーリーボード、ブランドビジュアル、商品シリーズに最適です。

画像1枚あたり約15秒 · バランスの取れた速度

画像1枚あたりの通常のレイテンシは約15秒です。4K + hdでは最大1分ほどかかる場合があります。デフォルトは500 RPMで、リクエストに応じて拡張できます。

柔軟なサイズ · 任意のアスペクト比

解像度プリセット（1K/2K/3K/4K）または正確なピクセル数を指定できます。総ピクセル数 ∈ [1280×720, 4096×4096]、アスペクト比 ∈ [1/16, 16]。

OpenAI SDKをそのまま利用

base_url=https://api.apiyi.com/v1を設定し、公式のOpenAI SDKで呼び出します。拡張パラメータはextra_body経由で渡します。移行時のコード変更は不要です。

出力サンプル

テキストからの画像生成 · ECサイトのメインビジュアル（seedream-5-0-flash; promptのみ：真っ白な背景に、淡い緑色の美容液ボトル。右上に「新品首发」、その下に「限时 8 折」と書かれた中国語ラベル）：17.1秒。2Kで中国語ラベルの画数が正確に描画され、誤字はありません。ボトルの形状と商用ライティングもきれいに表現されています。

Seedream 5.0 Flashのテキストからの画像生成サンプル：白背景の美容液メインビジュアル。中国語ラベルも明瞭

画像編集 · 背景の変更と値札の追加（seedream-5-0-flash; 参照画像はラーメンを真上から撮影した写真。prompt：背景を暗い木製テーブルに変更し、丼の右上に「招牌豚骨 38 元」と書かれた中国語の値札を追加）：33.2秒。値札に誤字はなく、ラーメン、トッピング、湯気は元のまま保たれています。暗い木目が被写体を引き立てています。

Seedream 5.0 Flashの編集サンプル：ラーメンの背景を暗い木目に変更し、中国語の値札を追加

料金

画像単位の課金で、BytePlus 公式と同価格です。チャージボーナスにより、実質単価をさらに抑えられます。

モデル	APIYI 価格	定価（人民元換算）	ステータス
`seedream-5-0-flash-260915`	$0.018 / リクエスト（1画像）	≈ ¥0.126 / リクエスト	🆕 最新 · 高速ティア（1画像あたり約15〜20秒、シリーズ中最安）
`seedream-5-0-pro-260628`	$0.12 / リクエスト（1画像）	≈ ¥0.84 / リクエスト	Pro ティア（1画像あたり約2分、日常業務には 5.0-lite を推奨）
`seedream-5-0-260128`	$0.035 / 画像	≈ ¥0.245 / 画像	✅ 推奨
`seedream-4-5-251128`	$0.04 / 画像	≈ ¥0.28 / 画像	✅ 推奨
`seedream-4-0-250828`	$0.03 / 画像	≈ ¥0.21 / 画像	🟡 提供継続中（呼び出し可能）

課金に関する注意事項:

prompt の長さやフュージョンモードに関わらず、生成された画像ごとに課金されます
seedream-5-0-flash は BytePlus 公式価格と同じく 1リクエストあたり一律 $0.018 で課金され、参照画像は無料です（弊社テストでは、参照画像が1枚、3枚、10枚のいずれの場合も $0.018 が課金されました）
seedream-5-0-pro は 1リクエストあたり一律 $0.12 で課金されます（1リクエストにつき1画像。バッチシーケンスは非対応）。公式では、出力ピクセル数による2段階の価格帯（2.36M px以下と2.36M px超で異なる価格）に加え、2枚目以降の参照画像に対する画像ごとの追加料金が設定されていますが、APIYI ではこれをリクエスト単位の一律料金に簡素化しています——価格帯の区分はなく、入力画像の料金も含まれます。このモデルには公式の割引が一切ありません。APIYI では供給保証ベースで価格を設定しており、チャージボーナスや税コストを考慮すると実質的に利益ゼロで提供しています。なお、価格の変更がある場合は事前にお知らせします
sequential_image_generation: "auto" モードでは、実際の出力枚数に応じて課金されます（例：max_images: 4 が4枚出力 → 4枚分を課金）
失敗したリクエスト（4xx / モデレーションによる遮断）は課金されません
無料トライアル：初回登録時に200枚の無料画像（BytePlus 提供）
チャージボーナスの詳細：チャージキャンペーンを参照してください

技術仕様

項目	seedream-5-0-flash	seedream-5-0-pro	seedream-5-0	seedream-4-5	seedream-4-0
モデルID	`seedream-5-0-flash-260915`	`seedream-5-0-pro-260628`	`seedream-5-0-260128`	`seedream-4-5-251128`	`seedream-4-0-250828`
モデルIDエイリアス	—	—	`seedream-5-0-lite-260128`	—	—
リリース日	2026-09-15 (UTC+8)	2026-06-28 (UTC+8)	2026-01-28 (UTC+8)	2025-11-28 (UTC+8)	2025-08-28 (UTC+8)
解像度ティア	1K / 1.5K / 2K + 正確なWxH指定（総ピクセル数0.92M〜4.62M、縦横比 ≤ 16:1）	1K / 2K + 正確なWxH指定（総ピクセル数 ≤ 4.19M、16:9時に長辺最大2720、約2.7K）	2K / 3K	2K / 4K	1K / 2K / 4K
出力フォーマット	`png` / `jpeg`（レイヤー分離による透過レイヤー）	`png` / `jpeg`	`png` / `jpeg`	`jpeg`	`jpeg`
prompt最適化	標準	標準 / 高速	標準	標準	標準 / 高速
テキストからの画像生成	✅	✅	✅	✅	✅
単一画像編集	✅	✅	✅	✅	✅
複数画像合成	✅（最大10枚）	✅（最大10枚）	✅	✅（最大10枚）	✅
バッチシーケンス	❌（指定時は400）	❌（指定時は400）	✅	✅	✅
ストリーミング出力	❌（指定時は400）	❌（指定時は400）	✅	✅	✅
1分間あたりの最大画像数（RPM）	500	500	500	500	500
単一リクエストの入力 + 出力	入力 ≤ 10、出力 1	入力 ≤ 10、出力 1	≤ 15	≤ 15	≤ 15
一般的なレイテンシ	15〜20秒	約2分	約30秒	10〜20秒	10〜15秒
レスポンスフィールド	同上	同上	`data[].url` または `data[].b64_json`	同上	同上

生成時間の比較

バージョンごとの単一リクエストのレイテンシ測定値（2026-07測定、5.0 Flashは2026-09-24測定、UTC+8。リクエストから完全なレスポンスまでの実測時間 — リクエストごとの通常の変動が見込まれます）：

シナリオ	seedream-4-0	seedream-4-5	seedream-5-0	seedream-5-0-pro	seedream-5-0-flash
テキストから画像生成 (1K/2K)	7-11s	8-13s	29-34s	110-130s	14-20s
テキストから画像生成（最高解像度）	~15s (4K)	~18s (4K)	~37s (3K)	~134s（WxH 2720×1530、最大サイズ）	~19s（WxH 2688×1712、最大サイズ）
編集 / 複数画像合成	~11s	17-21s	38-40s	115-132s	~16s（1〜3画像） / ~28s（10画像）
バッチシーケンス（2画像、編集 + 自動）	—	~36s	—	—（非対応）	—（非対応）
推奨クライアントタイムアウト	≥ 60s	≥ 60s	≥ 120s	≥ 240s	≥ 60s

seedream-5-0-pro は一貫して1画像あたり約2分かかります（例外なくすべての実行で110〜132sを測定）。これは深い推論を行う画像モデルとしての想定された挙動であり、不具合ではありません。pro を採用する前に、プロダクト側でこのレイテンシを許容できるかご確認ください。インタラクティブなフロー（ユーザーが画面の前で待機する処理）には適していません。代わりに 5.0-lite（約30s）をご利用ください。pro は、画質と指示への追従性が最も重視されるオフラインのバッチ生成に適しています。

APIエンドポイント

エンドポイント	用途	Content-Type
`POST /v1/images/generations`	テキストから画像生成 / 単一画像編集 / 複数画像合成 / バッチシーケンス — すべてのモードで1つのエンドポイントを共有し、リクエストボディのパラメータで切り替えます	`application/json`

ドメインの選択: api.apiyi.com がプライマリエンドポイントです。b.apiyi.com やその他のゲートウェイドメインも利用可能で、動作は同一です。ark.ap-southeast.bytepluses.com / ark.eu-west.bytepluses.com のようなBytePlusネイティブドメインを使用する必要はありません — APIYIがすべてをOpenAI互換のパスに正規化します。

主要パラメーターの詳細

`size`（出力サイズ）

2つの値系統があります — いずれかを選択してください： プリセットティア（モデルがアスペクト比を決定）：

ティア	概算ピクセル数	対応モデル
`1K`	~1024×1024	4.0 / 5.0-pro / 5.0-flash
`1.5K`	~1536×1536	5.0-flash のみ
`2K`	~2048×2048（デフォルト）	全バージョン
`3K`	~3072×3072	5.0 のみ
`4K`	~4096×4096	4.5 / 4.0

正確なピクセル数（カスタム）：

総ピクセル数 ∈ [1280×720, 4096×4096]
アスペクト比 ∈ [1/16, 16]
デフォルト：2048x2048

有効な例：1920x1080（FullHD）、3840x2160（横向き4K）、1080x1920（スマートフォンの縦向き）、2560x1440（横向き2K） 無効な例：5000x5000（上限超過）、100x1600（アスペクト比が1/16未満）

総ピクセル数が 4096×4096 を超えるサイズは 400 を返します。極端なアスペクト比（1/16 または 16 に近い値）は不自然に引き伸ばされる可能性があるため、プリセットまたは一般的な 16:9 / 9:16 / 1:1 の使用をおすすめします。5.0 シリーズのモデルは、4.x とは異なる正確なピクセル数の範囲を使用します（下限が高く、上限が低くなります）。範囲外のサイズは 400 を返し、エラーメッセージに有効な範囲が含まれます。実測の参考値：5.0-lite の下限は約 2560×1440 です。5.0-pro は総ピクセル数の上限が 4.19M です（最大 2048×2048。16:9 では長辺が 2720×1530 ≈ 2.7K に達し、動作確認済み）— 3K/4K プリセットはありません。5.0-flash は 921,600〜4,624,220 の総ピクセル数（約 0.92M〜4.62M）、最大 16:1 の辺比に対応しており、こちらも 3K/4K プリセットはありません。プリセットを使用するとモデルがコンテンツからアスペクト比を選択するため、固定の比率が必要な場合は正確なピクセル数を指定してください。

`image` および `sequential_image_generation`（モード切り替え）

/v1/images/generations エンドポイントは、テキストからの画像生成と編集／融合の両方をカバーしています。2つのパラメーターを組み合わせてモードを選択します：

モード	`image`	`sequential_image_generation`	備考
純粋なテキストからの画像生成	省略	省略または `"disabled"`	出力1件
単一画像の編集	`["url1"]`	`"disabled"`	1枚の参照画像に基づく編集
複数画像の融合	`["url1", "url2", ...]`	`"disabled"`	最大10枚の参照画像。「image 1 / image 2」のように参照
バッチシーケンス	任意	`"auto"` + `sequential_image_generation_options.max_images`	N件の一貫した出力、N ≤ max_images かつ入力 + 出力 ≤ 15

seedream-5-0-pro および seedream-5-0-flash は sequential_image_generation パラメーターを受け付けません — いずれの値（"disabled" を含む）を渡しても 400 が返されます。これら2つのモデルで編集／融合を行う場合は、image のみを渡し、このパラメーターは完全に省略してください。stream についても同様です。

完全なコード例については、テキストからの画像生成および画像編集を参照してください。

ベストプラクティス

適切なバージョンを選択する

大量処理／ポスターレイアウト／速度とコスト重視 → seedream-5-0-flash-260915 ($0.018/リクエスト、約15〜20秒、最大約2K)
最もバランスの取れた総合体験 → seedream-5-0-260128 (最多の機能、ただし最大3Kの上限あり)
4K + 強力なテキスト描画 → seedream-4-5-251128 (4K + テキスト描画のブレークスルー)
4K + 最適な価格 → seedream-4-0-250828 (最も安価な4K)
最高峰の画質／複雑な指示（プロフェッショナル用途） → seedream-5-0-pro-260628 ($0.12/リクエスト、画像1枚あたり約2分、1K/2Kのみ — 日常的な使用には非推奨)

プリセットサイズを優先する

1K/2K/3K/4Kは、安定した速度と品質のためにBytePlusによって最適化されています。実際のアスペクト比要件がある場合にのみ、正確なピクセル数を指定してください。サポートされているティアのバージョンによる違いにご注意ください。

画像を明示的に参照する

複数のimage URLを指定する場合は、モデルに推測させるのではなく、「画像1の人物を画像3のカラーパレットを使って画像2のシーンに配置する」のように、明示的な参照を含めてpromptを記述してください。

バッチシーケンスのコストを管理する

sequential_image_generation: "auto" + max_images: 4は4件出力され、課金は4倍になります。まずはmax_images: 1で検証してからスケールアップしてください。

用途に応じて出力形式を選択する

5.0シリーズはpngとjpegをサポートしています。4.5 / 4.0はjpegのみをサポートします。可逆圧縮のディテールが必要な場合はpngを使用し（5.0-flashのpngは直接生成時にはアルファチャンネルを持ちません。透明度が必要な場合はレイヤー分離を使用してください）、ファイルサイズを重視するシナリオではjpegを使用してください。

クライアントのタイムアウトを60秒以上に設定する

単一画像の場合は約15秒ですが、バッチシーケンス（4画像）や4K + hdの場合は30〜60秒かかることがあります。まずは60秒のクライアントタイムアウトから開始し、UIに進捗のフィードバックを表示してください。seedream-5-0-proは画像1枚あたり約2分かかります — 240秒以上のタイムアウトを設定してください。

必要に応じて透かしを無効化する

BytePlusの透かしを削除するにはwatermark: falseを設定してください（デフォルト値はバージョンによって異なるため、明示的に設定してください）。商用アセットには必須です。

エラーコードと再試行

ステータス	意味	推奨対応
`400`	無効なパラメータ（サイズが範囲外、`image` array > 10、未対応の tier）	使用中のバージョンでサポートされている tier を確認してください
`401`	無効な token	Bearer Token を確認してください
`403`	コンテンツモデレーションによりブロックされました	prompt を調整するか、参照画像を差し替えてください
`429`	rate limit（デフォルト 500 RPM）または残高不足	指数バックオフを適用してください。より高い RPM が必要な場合は営業にお問い合わせください
`5xx`	ゲートウェイ / upstream エラー	1〜2回再試行してください
Timeout	長い応答時間のリクエスト	クライアントタイムアウトは ≥ 60s（バッチシーケンスまたは 4K + hd では 60s に達する場合があります）

クライアント向けの推奨事項:

60秒のリクエストタイムアウトから始めてください（バッチシーケンスまたは 4K + hd では 1分かかる場合があります）
5xx とタイムアウトには 指数バックオフ を適用してください（推奨再試行回数は 2回です）
サポートチケット用に x-request-id レスポンスヘッダーを記録してください

FAQ

5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0 — どれを選ぶべきですか？

ニーズ	推奨
大量処理 / ポスターレイアウト / 速度とコスト重視	`seedream-5-0-flash-260915` ($0.018/リクエスト、約15〜20秒)
最新機能 + 最高の総合性能	`seedream-5-0-260128`
4K + 強力なテキスト描画（ポスター、広告）	`seedream-4-5-251128`
4K + 最良の価格	`seedream-4-0-250828`
長期的に安定したバッチ生成	`seedream-4-0-250828`（実績豊富、最安、高速 prompt モード）
最高峰の画質 / 複雑な指示（プロ向け用途）	`seedream-5-0-pro-260628` ($0.12/リクエスト、画像あたり約2分 — 必要な場合を除きスキップを推奨)

完全な比較については過去のバージョンをご覧ください。

なぜ画像編集でも generations エンドポイントを使用するのですか？

Seedream は生成と編集の統合アーキテクチャを採用しており、個別の /v1/images/edits エンドポイントはありません。OpenAI の gpt-image-2（/v1/images/edits へのマルチパートアップロード）とは異なり、Seedream は application/json を使用し、image フィールドに画像 URL を配列として 渡します。メリット：プロトコルの一貫性、パラメータの再利用、容易なモード切り替え。詳細は画像編集をご覧ください。

image フィールドは base64 を受け入れますか？

はい（テストにより検証済みです）。データ URI を使用します：data:image/<format>;base64,<base64 string>（<format> は小文字、例：data:image/jpeg;base64,...）。URL と base64 のエントリは同じ配列内で混在させることができます。可能な限り公開 URL を優先してください：URL は APIYI ゲートウェイを経由せずに BytePlus がシンガポールから直接ダウンロードしますが、base64 のボディは国境を越えて全体をアップロードする必要があります。回線が遅い場合、20 MB を超えるボディはプロバイダーの 600 秒のリクエストボディタイムアウトに達する可能性があり、ゲートウェイが base64 を URL に変換することはありません。画像編集ページの上部にある警告をご覧ください。

複数画像の融合の制限は？バッチシーケンスの制限は？

複数画像の融合（image 配列）：4.5 / 5.0-pro / 5.0-flash は明示的に最大 10 個までサポートしています（当社のテストでは 5.0-flash で 11 個目を指定すると 400 が返されました）。5.0 / 4.0 も複数画像をサポートしていますが、明示的な上限はドキュメントに記載されていません。
バッチシーケンス（max_images）：グローバルルールである 入力参照 + 出力 ≤ 15 に制限されます。融合とシーケンスを組み合わせる場合は、合計をカウントしてください。なお、5.0-pro および 5.0-flash はバッチシーケンスをサポートしていません（sequential_image_generation を渡すと 400 が返されます）。

b64_json には data:image プレフィックスが必要ですか？

response_format によって異なります：

response_format: "url"（デフォルト）→ data[0].url は一時的な署名付き URL であり、<img src=...> で直接レンダリングできます
response_format: "b64_json" → data[0].b64_json はプレーンな base64 文字列です（data:image/...;base64, プレフィックスなし）。デコードしてディスクに書き込むか、ブラウザでレンダリングするために手動でプレフィックスを先頭に付加してください。

ストリーミング出力はサポートされていますか？

stream: true 経由で 5.0 / 4.5 / 4.0 でサポートされています。ストリーミングは、長い prompt や高解像度画像に特に有用であり、フロントエンドで部分的な結果を段階的にレンダリングできます。seedream-5-0-pro および seedream-5-0-flash はストリーミングをサポートしていません — stream を渡すと 400 が返されます。

レート制限は？

デフォルトは毎分 500 画像（Max Images per Minute）で、バージョン共通です。より高いクォータが必要な場合は営業担当までお問い合わせください。

失敗したリクエストは課金されますか？

いいえ。BytePlus にはモデレーション機能が組み込まれています。モデレーションによる拒否やパラメータエラーは 400 / 403 を返し、課金されません。課金が発生しないその他のエラー：401（無効な token）、429（レート制限）。生成が成功した場合（有効なレスポンスを伴う 200）のみ課金されます。

公式の OpenAI SDK を使用できますか？

はい、コードを変更することなく使用できます。base_url を https://api.apiyi.com/v1 に向け、extra_body 経由で拡張パラメータ（image / sequential_image_generation / watermark など）を渡します：

from openai import OpenAI

client = OpenAI(api_key="sk-your-key", base_url="https://api.apiyi.com/v1")
resp = client.images.generate(
    model="seedream-5-0-260128",
    prompt="...",
    size="2K",
    extra_body={
        "image": ["https://.../ref.png"],
        "sequential_image_generation": "disabled",
        "watermark": False,
    }
)

生成された画像の所有権は誰に帰属しますか？

生成された画像は商用および非商用で利用できます。詳細は BytePlus の利用規約をご覧ください。

透明な背景はサポートされていますか？

seedream-5-0 / seedream-5-0-pro は png 出力をサポートしており、prompt で指示した場合（「transparent background, alpha channel」）に透明な背景を生成できます。seedream-5-0-flash は透明な背景を要求してもアルファチャンネルを返しません。背景ベースと複数の透明レイヤーを取得するには layer_decomposition: true を使用してください（出力画像ごとに課金）。詳細は画像編集をご覧ください。seedream-4-5 / 4-0 は jpeg のみを出力し、透過をサポートしていません — ご自身で背景を削除する後処理を行ってください。

実行中の生成をキャンセルできますか？

いいえ。/v1/images/generations は同期処理です。リクエストは一度送信されると、完了するまで実行されます。クライアントの接続が切断されても、サーバー側では処理が完了し、課金されます。クライアント側のタイムアウトを設定し、切断によってコストを抑えられるとは想定しないようにしてください。

​概要

Text-to-Image API

画像編集 API

過去のバージョン

​AIエージェントに統合を任せる

​APIYIのSeedreamが選ばれる理由

戦略的パートナーシップ・安定したリソース

無制限の同時実行数・エンタープライズ対応

同等価格 ＋ チャージで最大20%オフ

グローバルでフリクションレスなアクセス

OpenAI互換・コード変更不要

プロフェッショナルサポート・エンタープライズコンシェルジュ

​主な機能

高精細な4K出力

生成と編集を統合

最大10枚の参照画像を融合

テキスト描画の飛躍的な進歩

最大15枚のバッチ連続生成

画像1枚あたり約15秒 · バランスの取れた速度

柔軟なサイズ · 任意のアスペクト比

OpenAI SDKをそのまま利用

​出力サンプル

​料金

​技術仕様

​生成時間の比較

​APIエンドポイント

​主要パラメーターの詳細

​size（出力サイズ）

​image および sequential_image_generation（モード切り替え）

​ベストプラクティス

​エラーコードと再試行

​FAQ

​関連ドキュメント

概要

AIエージェントに統合を任せる

APIYIのSeedreamが選ばれる理由

同等価格＋チャージで最大20%オフ

主な機能

出力サンプル

料金

技術仕様

生成時間の比較

APIエンドポイント

主要パラメーターの詳細

`size`（出力サイズ）

`image` および `sequential_image_generation`（モード切り替え）

ベストプラクティス

エラーコードと再試行

FAQ

関連ドキュメント