メインコンテンツへスキップ
Seedream 5.5
Seedream 5.5 は ByteDance の画像生成・編集モデルです。doubao-seedream-5-5-261028 で、テキストからの生成、参照画像の編集、透過画像の生成、編集可能なレイヤーへの分解を行います。 POST https://api.mixroute.ai/v1/images/generations 画像生成エンドポイントに JSON を送信し、Authorization: Bearer $MIXROUTE_API_KEY と Content-Type: application/json を指定します。パラメーターはトップレベルに置き、metadata で囲みません。参照画像の編集とレイヤー分解も同じエンドポイントを使い、/v1/images/edits や Chat Completions は使用しません。
MixRoute ではレイヤー分解を含むすべてのリクエストに prompt が必要です。上流の例で任意とされていても省略しないでください。

リクエストパラメーター

画像・サイズ・制限

  • 通常の生成は 1 リクエスト 1 枚です。n では出力数を変更できません。ストリーミング、連続画像生成、ウェブ検索は非対応のため、stream、sequential_image_generation、検索ツールのフィールドは省略します。
  • 参照画像は 1 枚 30 MB 以下、アスペクト比は 1:16-16:1 です。Base64 data URL の形式名は小文字にします。例:data:image/png;base64,...。
  • 生成の解像度プリセットでは prompt にアスペクト比を記述します。幅x高さ は小文字の x を使い、総ピクセル数 921,600-4,624,220、アスペクト比 1:16-16:1 を満たす必要があります。2880x1440 は有効です。制限は幅と高さの積であり、各辺の長さではありません。
  • 分解には総ピクセル数 262,144(512 x 512)以上の PNG または JPEG を 1 枚指定します。size: auto は入力の寸法とアスペクト比に応じて調整するため、全出力が元のピクセル寸法を保つとは限りません。各 data[].size を確認してください。
  • いずれかのレイヤー生成に失敗すると分解リクエスト全体が失敗します。max_images を超える出力を指示すると、指定した要素の一部が欠けることがあります。

リクエスト例

MIXROUTE_API_KEY に MixRoute のキーを設定します。送信前に、以下の example.com の入力 URL をアクセス可能な画像 URL に置き換えてください。

テキストから画像を生成

複数の参照画像

透過 PNG

OCR 付きレイヤー分解

Python OpenAI SDK

openai パッケージをインストールし、MIXROUTE_API_KEY と SEEDREAM_IMAGE_URL を設定します。Seedream 固有のフィールドや解像度値は SDK の extra_body に入れます。送信時にはトップレベルの JSON に統合され、extra_body や metadata オブジェクトにはなりません。生成の無条件な再実行を避けるため、自動再試行を無効にしています。

レスポンスフィールド

ベース画像 1 枚とレイヤー 1 枚を含むレスポンスの例です。

レイヤーを再合成する

z_index: 0 のベース画像をキャンバスにします。各レイヤーを bounding_box.absolute に従って (right - left) x (bottom - top) にリサイズし、(left, top) に配置して、z_index の昇順にアルファ合成します。レイヤーの元の size と配置寸法は異なる場合があります。OCR は文字情報を返すもので、実際の文字編集はアプリケーション側で行います。

課金

入力画像と正常に出力された画像を、それぞれ枚数で課金します。出力の料金区分は、指定したサイズ名だけでなく各画像の実際の幅と高さの積で決まります。以下は現在の公開価格と一致する標準 USD 料金です。アカウントとルートの実際の価格はモデルマーケットプレイスを優先してください。
  • 参照画像または分解対象の画像はそれぞれ入力画像として数えます。ベース画像と正常に生成された各レイヤーは別々の出力画像で、それぞれのピクセル数に応じた料金区分を使います。生成に失敗した画像は課金対象外です。
  • 分解では max_images に基づいてクレジットを仮引き落としし、完了後に実際の出力枚数で精算して未使用分を返します。残高が少ない場合は上限を小さくしてください。
  • 例:入力 1 枚、正常な出力 3 枚がすべて 2,610,000 ピクセルを超える場合、標準料金は 0.0075 + 3 * 0.0345 = 0.111 USD です。サイズが異なるレイヤーには別の料金区分が適用される場合があります。実際の請求額は使用ログで確認してください。

よくあるエラー

モデル紹介