Skip to main content

概要

Seedream は ByteDance BytePlus ModelArk の主力の画像生成モデルシリーズで、生成・編集の統合アーキテクチャを備えています。テキストから画像生成、単一画像編集、複数画像融合、バッチシーケンス生成のすべてが 1 つの /v1/images/generations エンドポイントで動作し、違いはパラメータだけです。APIYI は BytePlus と戦略的パートナーシップを結んでおり、稼働中のすべてのバージョンを初日から統合しています。
🎨 特長: 統一課金のもとで稼働中の 3 つのバージョン(5.0 / 4.5 / 4.0)+ 4K 出力 + 融合用の参照画像を最大 10 枚 + バッチ(入力 + 出力 ≤ 15)+ 先進的なテキスト描画。Eコマースのヒーロー画像、広告ポスター、商品写真、コンテンツ制作に最適 — 高品質と読みやすいテキストが重要なあらゆる場面に向いています。
すべての画像 API は同期型です — ポーリングする task ID はなく、クライアントが切断されると、リクエストは課金されたままでも結果は失われます。このモデルでは十分に長いタイムアウトを設定してください。画像 API の基本とベストプラクティス を参照してください。
どの Seedream ですか? APIYI では Seedream をBytePlus の海外向け公式(国際版)リソースで提供しています — 中国本土の Doubao / Volcengine 版ではありません。国際版は国内版よりも比較的緩やかなコンテンツモデレーション方針を採用しているため、より自由に制作できます。これはこのプラットフォームの大きな利点ですが、モデレーションが不要という意味ではありません。BytePlus には組み込みのコンテンツ安全性チェックがあり、違反する prompt や参照画像は 400/403 で拒否されます(拒否は課金対象外です)。コンプライアンスの範囲内でご利用ください。

テキストから画像生成 API

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

画像編集 API

同じエンドポイントに image パラメータを指定します。単一画像編集、複数画像融合、バッチシーケンス(最大 15 枚の画像)に対応します。

旧バージョン

5.0 / 4.5 / 4.0 の仕様比較、価格差、移行ガイド。

APIYIのSeedreamが選ばれる理由

BytePlus ModelArk 公式チャネルのドロップイン代替として、本番利用向けに 安定性コスト統合性 の3軸で最適化されています:

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

BytePlus ModelArk への公式な直接接続です。リクエストとレスポンスの挙動は上流と同一で、プロトコルの回避はなく、本番環境でも安心して利用できます。

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

バッチ生成、複数画像の融合、シーケンス生成をリニアにスケールできます。Tier型のアカウント制限はありません。デフォルトは 500 RPM で、より高いクォータが必要な場合は営業までお問い合わせください。

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

標準の単価は BytePlus 公式価格と一致します。チャージ特典 と組み合わせることで、実質価格は定価の 最安80% まで下がります。

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

海外サーバーやプロキシは不要です。中国本土のデータセンター、住宅ネットワーク、海外ノードから 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つのエンドポイントと1つのパラメータセットを共有します。モードはimagesequential_image_generationで切り替えます。

マルチ画像融合 · 最大10件の参照

imageは URL 配列を受け取ります。プロンプト内で「image 1 / image 2」と指定すると、順序を明示できます。被写体の一貫性を保った融合にはsequential_image_generation: "disabled"を組み合わせます。

テキスト描画のブレークスルー

4.5 リリースでは、小さい文字の可読性が大幅に向上しました。ポスター、広告コピー、商品テキストは鮮明で正確です — クラス最高水準です。

バッチシーケンス(最大15件)

sequential_image_generation: "auto"max_imagesで一貫したシリーズを出力します — ストーリーボード、ブランドビジュアル、製品シリーズに最適です。

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

通常の単画像レイテンシは約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で渡します。移行時のコード変更は不要です。

価格

画像ごとの課金で、BytePlus公式と同価格です。チャージ特典により、実質単価はさらに下がります。
課金に関する注意:
  • 生成された画像ごとに課金され、promptの長さや融合モードにかかわらず同じです
  • seedream-5-0-pro1リクエストあたり固定 $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で測定。リクエストから完全な応答までのウォールクロック時間であり、通常のリクエストごとのばらつきがあります):
seedream-5-0-pro は画像1枚あたり約2分かかります(110-132s は全実行で測定され、例外はありません)。これは深い推論を行う画像モデルとしては想定どおりの挙動であり、不具合ではありません。pro を採用する前に、プロダクトがこのレイテンシを受け入れられるか確認してください。画面の前でユーザーを待たせる対話型フローには不向きです。その場合は 5.0-lite(約30s)を使ってください。pro は、画像品質と指示への忠実さが最も重要なオフラインのバッチ制作に適しています。

API エンドポイント

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

詳細な主要パラメータ

size(出力サイズ)

2つの値の系統があります — どちらか1つを選んでください: プリセットティア(モデルがアスペクト比を決定します): 正確なピクセル数(カスタム):
  • 総ピクセル数 ∈ [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のプリセットはありません

imagesequential_image_generation(モード切り替え)

/v1/images/generations エンドポイントは、テキストから画像生成と編集/融合の両方をカバーします。2つのパラメータを組み合わせてモードを選択します:
seedream-5-0-prosequential_image_generation パラメータを受け付けません — いかなる値("disabled" を含む)を渡しても400が返ります。Proモデルで編集 / 融合を行う場合は、image のみを指定し、パラメータ自体は完全に省略してください。stream にも同じことが当てはまります。
完全なコード例は、テキストから画像生成画像編集 をご覧ください。

ベストプラクティス

1

適切なバージョンを選ぶ

  • 総合的に最も優れた体験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のみ — 日常利用にはおすすめしません)
2

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

1K/2K/3K/4K は、安定した速度と品質が得られるよう BytePlus によって調整されています。実際のアスペクト比要件がある場合にのみ、正確なピクセル値を使用してください。対応ティアはバージョンごとに異なる点に注意してください。
3

画像を明示的に参照する

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

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

sequential_image_generation: "auto" + max_images: 4 は出力が4件になります — 課金は × 4 です。まず max_images: 1 で検証してから、規模を拡大してください。
5

用途に応じて出力形式を選ぶ

5.0 / 5.0-pro は pngjpeg に対応し、4.5 / 4.0 は jpeg のみです。透過背景やロスレスなディテールが必要な場合は 5.0 シリーズ + png を使い、サイズ重視のシナリオでは jpeg を使ってください。
6

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

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

必要な場合はウォーターマークを無効化する

BytePlus のウォーターマークを削除するには、watermark: false を設定します(既定値はバージョンによって異なるため、明示的に設定してください)。商用アセットでは必須です。

エラーコードと再試行

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

FAQ

履歴バージョンで完全な比較をご覧ください。
Seedream は統合された生成・編集アーキテクチャを採用しており、専用の /v1/images/edits エンドポイントはありません。OpenAI の gpt-image-2(/v1/images/edits への multipart アップロード)とは異なり、Seedream は application/json を使い、画像の URL を配列 として image フィールドに渡します。利点は、プロトコルの一貫性、パラメーターの再利用、モード切り替えの容易さです。詳しくは画像編集をご覧ください。
はい(テストで確認済み)です。data URI を使います: 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 が返ります)。
response_format によります:
  • response_format: "url"(デフォルト)→ data[0].url は一時的な署名付き URL です。<img src=...> でそのままレンダリングできます
  • response_format: "b64_json"data[0].b64_jsonプレーンな base64 文字列です(data:image/...;base64, プレフィックスなし)。デコードしてディスクに書き込むか、ブラウザでレンダリングする場合はプレフィックスを手動で付けてください。
5.0 / 4.5 / 4.0 では stream: true 経由でサポートされています。ストリーミングは長い prompt と高解像度画像で特に有用で、フロントエンドは部分結果を段階的にレンダリングできます。seedream-5-0-pro はストリーミングをサポートしていませんstream を渡すと 400 が返ります。
デフォルトは1分あたり500 images(Max Images per Minute)です。バージョン間で共通です。より高いクォータについては営業にお問い合わせください。
いいえ。BytePlus には組み込みのモデレーションがあります。モデレーション拒否とパラメーターエラーは 400 / 403 を返し、課金されません。そのほかの非課金エラーは 401(無効な token)、429(レート制限)です。正常に生成された場合(有効なレスポンスを伴う 200)のみ課金されます
はい、コード変更なしで使えます。base_urlhttps://api.apiyi.com/v1 に向け、拡張パラメーター(image / sequential_image_generation / watermark など)は extra_body 経由で渡します:
生成された画像は商用・非商用の両方で使用できます。詳細は BytePlus の利用規約をご覧ください。
seedream-5-0 / seedream-5-0-propng 出力をサポートしており、プロンプトで「transparent background, alpha channel」と指定すると透明背景を生成できます。seedream-4-5 / 4-0jpeg のみを出力し、透明には対応していません — 背景除去は後処理でご自身で行ってください。
いいえ/v1/images/generations は同期です。送信後、リクエストは完了まで実行されます。クライアントが切断されても、サーバーは処理を完了し、課金も行われます。クライアントのタイムアウトを設定し、切断すればコストを節約できると考えないでください。

関連ドキュメント

Seedream は、APIYI と BytePlus ModelArk の戦略的パートナーシップを通じて提供されています。3つのバージョンは、1つの統合、課金、認証パスを共有しています — 必要に応じて選択してください。ご質問やフィードバックがある場合は、コンソールからチケットを起票してください。