画像生成

POST

/v1/images/generations

• プロンプトや入力画像を元に、モデルが新しい画像を生成します。
• テキストから画像生成、画像編集、複数画像の融合などのシナリオに対応。
• seedream-5.0/4.5/4.0/3.0-t2i、seededit-3.0-i2i の各種モデルに対応。

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

• 対応：テキストから画像生成
  • doubao-seedream-3-0-t2i-250415
• 対応：画像編集
  • doubao-seededit-3-0-i2i-250628
• 対応：テキストから画像生成、画像から画像生成
  • doubao-seedream-5-0-260128
  • doubao-seedream-4-5-251128
  • doubao-seedream-4-0-250828

画像生成に使用するプロンプト。

生成された画像の返却形式を指定します。以下の2つの返却方法に対応しています：

• url：画像のダウンロードリンクを返します。リンクは画像生成後24時間有効です。お早めにダウンロードしてください。
• b64_json：Base64エンコードされた文字列としてJSON形式で画像データを返します。

デフォルト値：url

string

doubao-seedream-3.0-t2i/seededit-3.0-i2i のみがこのパラメータに対応しています。
モデルが生成するコンテンツのランダム性を制御するためのランダムシードです。値の範囲：[-1, 2147483647]。
注意：

• 同じリクエストで、モデルが異なるseed値を受け取った場合（seed値を指定しない、seedを-1に設定してランダム値を使用、またはseed値を手動で変更）、異なる結果が生成されます。
• 同じリクエストで、モデルが同じseed値を受け取った場合、類似の結果が生成されますが、完全な一致は保証されません。

モデルの出力結果とプロンプトの一貫性の度合いであり、画像生成の自由度です。テキストウェイトとも呼ばれます。値が大きいほど、モデルの自由度が低くなり、ユーザーの入力プロンプトとの関連性が強くなります。値の範囲：[1, 10]。

• doubao-seedream-3.0-t2i デフォルト値：2.5
• doubao-seededit-3.0-i2i デフォルト値：5.5
• doubao-seedream-5.0-lite/4.5/4.0 は非対応

生成された画像にウォーターマークを追加するかどうか。

• false：ウォーターマークを追加しません。
• true：画像の右下に「AI生成」のウォーターマークを追加します。

デフォルト値：true

string |array

入力画像の情報です。URLまたはBase64エンコーディングに対応しています。

• 画像URL：画像URLにアクセスできることを確認してください。
• Base64エンコーディング：この形式に従ってください：data:image/<画像形式>;base64,<Base64エンコーディング>。<画像形式>は小文字である必要があります。例：data:image/png;base64,<base64_image>。

doubao-seedream-5.0-lite/4.5/4.0 のみがこのパラメータに対応しています。
シリーズ画像機能を制御します。入力した内容に基づいて、関連性のある画像グループを生成します。

• auto：自動判断モード。モデルはプロンプトに基づいて、シリーズ画像を返すかどうかと画像枚数を判断します。
• disabled：シリーズ画像機能を無効にし、モデルは1枚の画像のみを生成します。

デフォルト値：disabled

object

doubao-seedream-5.0-lite/4.5/4.0 のみがこのパラメータに対応しています。
シリーズ画像機能の設定です。sequential_image_generation が auto の場合のみ有効です。

doubao-seedream-5.0 のみがこのパラメータに対応しています。
生成画像のファイル形式を指定します。利用可能な値：

• png
• jpeg

デフォルト値：jpeg