概要
Seedream は ByteDance BytePlus ModelArk の主力の画像生成モデルシリーズで、生成・編集の統合アーキテクチャを備えています。テキストから画像生成、単一画像編集、複数画像融合、バッチシーケンス生成のすべてが 1 つの/v1/images/generations エンドポイントで動作し、違いはパラメータだけです。APIYI は BytePlus と戦略的パートナーシップを結んでおり、稼働中のすべてのバージョンを初日から統合しています。
テキストから画像生成 API
POST /v1/images/generations. prompt から 1K / 2K / 3K / 4K、または正確なピクセルサイズで画像を生成します。画像編集 API
image パラメータを指定します。単一画像編集、複数画像融合、バッチシーケンス(最大 15 枚の画像)に対応します。旧バージョン
APIYIのSeedreamが選ばれる理由
BytePlus ModelArk 公式チャネルのドロップイン代替として、本番利用向けに 安定性、コスト、統合性 の3軸で最適化されています:戦略的パートナーシップ · 安定したリソース
無制限の同時実行数 · エンタープライズ対応
同価格 + チャージで最大20%オフ
グローバルなゼロフリクションアクセス
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 を使用してください。プロフェッショナルサポート · エンタープライズコンシェルジュ
主な機能
4K高忠実度出力
生成・編集の統合
imageとsequential_image_generationで切り替えます。マルチ画像融合 · 最大10件の参照
imageは URL 配列を受け取ります。プロンプト内で「image 1 / image 2」と指定すると、順序を明示できます。被写体の一貫性を保った融合にはsequential_image_generation: "disabled"を組み合わせます。テキスト描画のブレークスルー
バッチシーケンス(最大15件)
sequential_image_generation: "auto"とmax_imagesで一貫したシリーズを出力します — ストーリーボード、ブランドビジュアル、製品シリーズに最適です。画像1枚あたり約15秒 · バランスの取れた速度
柔軟なサイズ · 任意のアスペクト比
1K/2K/3K/4K)またはピクセル指定。総ピクセル数 ∈ [1280×720, 4096×4096]、アスペクト比 ∈ [1/16, 16]。そのまま使える OpenAI SDK
base_url=https://api.apiyi.com/v1を設定し、公式 OpenAI SDK から呼び出します。拡張パラメータはextra_bodyで渡します。移行時のコード変更は不要です。価格
画像ごとの課金で、BytePlus公式と同価格です。チャージ特典により、実質単価はさらに下がります。- 生成された画像ごとに課金され、promptの長さや融合モードにかかわらず同じです
seedream-5-0-proは1リクエストあたり固定 $0.12で課金されます(1リクエストにつき画像1枚、バッチシーケンスは非対応)。公式には、このモデルは2つの出力ピクセル価格帯(≤2.36M px と >2.36M px でそれぞれ異なる価格)に加え、先頭以外の参照画像に対して画像ごとの料金がかかりますが、APIYIではこれを一律のリクエスト単価に簡略化しています。ティアはなく、入力画像料金も含まれます。このモデルには公式割引が一切ありません。APIYI は供給保証ベースで価格を設定しており、チャージ特典と税コストを考慮すると実質的に利益はありません。価格変更がある場合は事前に告知しますsequential_image_generation: "auto"モードでは、実際の出力数に応じて課金されます(例:max_images: 4の出力が4件なら、4件分課金)- 失敗したリクエスト(4xx / モデレーションによりブロックされたもの)は課金されません
- 無料トライアル: 初回オンボーディング時に200枚の画像が無料(BytePlus提供)
- チャージ特典の詳細: チャージプロモーション を参照
技術仕様
生成時間の比較
バージョンごとの単一リクエスト遅延の実測値です(2026-07、UTC+8で測定。リクエストから完全な応答までのウォールクロック時間であり、通常のリクエストごとのばらつきがあります):API エンドポイント
詳細な主要パラメータ
size(出力サイズ)
2つの値の系統があります — どちらか1つを選んでください:
プリセットティア(モデルがアスペクト比を決定します):
- 総ピクセル数 ∈ [1280×720, 4096×4096]
- アスペクト比 ∈ [1/16, 16]
- デフォルト:
2048x2048
1920x1080(FullHD)、3840x2160(横向き4K)、1080x1920(スマホ縦向き)、2560x1440(横向き2K)
無効な例: 5000x5000(上限超過)、100x1600(アスペクト比が1/16未満)
image と sequential_image_generation(モード切り替え)
/v1/images/generations エンドポイントは、テキストから画像生成と編集/融合の両方をカバーします。2つのパラメータを組み合わせてモードを選択します:
ベストプラクティス
適切なバージョンを選ぶ
- 総合的に最も優れた体験 →
seedream-5-0-260128(最も多機能ですが、3K上限) - 4K + 強力なテキスト描画 →
seedream-4-5-251128(4K + テキストのブレイクスルー) - 4K + 最安価格 →
seedream-4-0-250828(4Kで最も安価) - 最高画質 / 複雑な指示(業務用途) →
seedream-5-0-pro-260628($0.12/request、画像1枚あたり約2分、1K/2Kのみ — 日常利用にはおすすめしません)
プリセットサイズを優先する
1K/2K/3K/4K は、安定した速度と品質が得られるよう BytePlus によって調整されています。実際のアスペクト比要件がある場合にのみ、正確なピクセル値を使用してください。対応ティアはバージョンごとに異なる点に注意してください。画像を明示的に参照する
image URL がある場合は、モデルに推測させるのではなく、明示的な参照を含めて prompt を書いてください — 「画像1の人物を画像2のシーンに、画像3のカラーパレットを使って配置する」。バッチシーケンスのコストを管理する
sequential_image_generation: "auto" + max_images: 4 は出力が4件になります — 課金は × 4 です。まず max_images: 1 で検証してから、規模を拡大してください。用途に応じて出力形式を選ぶ
png と jpeg に対応し、4.5 / 4.0 は jpeg のみです。透過背景やロスレスなディテールが必要な場合は 5.0 シリーズ + png を使い、サイズ重視のシナリオでは jpeg を使ってください。クライアントのタイムアウトを 60 秒以上に設定する
seedream-5-0-pro は画像1枚あたり約2分かかるため、タイムアウトは240秒以上にしてください。必要な場合はウォーターマークを無効化する
watermark: false を設定します(既定値はバージョンによって異なるため、明示的に設定してください)。商用アセットでは必須です。エラーコードと再試行
- 60秒のリクエストタイムアウトから始めてください(バッチシーケンスまたは 4K + hd では 1分かかる場合があります)
- 5xx とタイムアウトには 指数バックオフ を適用してください(推奨再試行回数は 2回です)
- サポートチケット用に
x-request-idレスポンスヘッダーを記録してください
FAQ
5.0 Pro / 5.0 / 4.5 / 4.0 — どれを選ぶべきですか?
5.0 Pro / 5.0 / 4.5 / 4.0 — どれを選ぶべきですか?
画像編集でも generations エンドポイントを使うのはなぜですか?
画像編集でも generations エンドポイントを使うのはなぜですか?
/v1/images/edits エンドポイントはありません。OpenAI の gpt-image-2(/v1/images/edits への multipart アップロード)とは異なり、Seedream は application/json を使い、画像の URL を配列 として image フィールドに渡します。利点は、プロトコルの一貫性、パラメーターの再利用、モード切り替えの容易さです。詳しくは画像編集をご覧ください。image フィールドは base64 を受け付けますか?
image フィールドは base64 を受け付けますか?
data:image/<format>;base64,<base64 string> で、<format> は小文字にします(例: data:image/jpeg;base64,...)。URL と base64 のエントリは同じ配列に混在できます。ローカルの大きな画像では、画像ホストにアップロードして URL を渡すほうが、リクエストボディを小さく保てるため依然として推奨です。マルチ画像融合の上限は? バッチシーケンスの上限は?
マルチ画像融合の上限は? バッチシーケンスの上限は?
- マルチ画像融合(
image配列):4.5 / 5.0-pro は明示的に最大10まで対応しています。5.0 / 4.0 もマルチ画像に対応していますが、明示的な上限は文書化されていません。 - バッチシーケンス(
max_images):グローバルルール input references + output ≤ 15 によって制限されます。融合とシーケンスを組み合わせる場合は、合計で数えます。5.0-pro はバッチシーケンスをサポートしていません(sequential_image_generationを渡すと 400 が返ります)。
b64_json に data:image プレフィックスは必要ですか?
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 経由でサポートされています。ストリーミングは長い prompt と高解像度画像で特に有用で、フロントエンドは部分結果を段階的にレンダリングできます。seedream-5-0-pro はストリーミングをサポートしていません — stream を渡すと 400 が返ります。レート制限は?
レート制限は?
失敗したリクエストは課金されますか?
失敗したリクエストは課金されますか?
400 / 403 を返し、課金されません。そのほかの非課金エラーは 401(無効な token)、429(レート制限)です。正常に生成された場合(有効なレスポンスを伴う 200)のみ課金されます。公式 OpenAI SDK は使えますか?
公式 OpenAI SDK は使えますか?
base_url を https://api.apiyi.com/v1 に向け、拡張パラメーター(image / sequential_image_generation / watermark など)は extra_body 経由で渡します:生成された画像の権利は誰にありますか?
生成された画像の権利は誰にありますか?
透明背景はサポートされていますか?
透明背景はサポートされていますか?
seedream-5-0 / seedream-5-0-pro は png 出力をサポートしており、プロンプトで「transparent background, alpha channel」と指定すると透明背景を生成できます。seedream-4-5 / 4-0 は jpeg のみを出力し、透明には対応していません — 背景除去は後処理でご自身で行ってください。進行中の生成をキャンセルできますか?
進行中の生成をキャンセルできますか?
/v1/images/generations は同期です。送信後、リクエストは完了まで実行されます。クライアントが切断されても、サーバーは処理を完了し、課金も行われます。クライアントのタイムアウトを設定し、切断すればコストを節約できると考えないでください。関連ドキュメント
- Text-to-Image Playground —
POST /v1/images/generations、5言語のコードサンプル付き - Image Editing Playground —
image+sequential_image_generationパターン - Historical Versions — 5.0 / 4.5 / 4.0 の比較と移行
- API Manual — 一般的な呼び出しガイド
- Image Generation Sandbox — オンラインで試す
- BytePlus 公式ドキュメント:
docs.byteplus.com/en/docs/ModelArk/1824121— Seedream 4.0-5.0 チュートリアル