画像
Seedream
POST
Seedream
パラメータと使用方法は公式と一致しています。詳細なパラメータは公式ドキュメントを直接参照してください。
リクエストヘッダー：
選択したモデルの上流プロトコルで、グループ画像パラメータの使用可能な値と枚数の制限を確認してください。
一、概要
Seedream 画像生成 API は OpenAI スタイルの画像生成リクエスト形式を使用し、テキスト-to-画像、画像-to-画像、画像編集をサポートします。4つのモデルは同じインターフェースを使用し、クライアントはリクエスト body の model フィールドでモデルを選択するだけです。サポートされるモデル
二、インターフェースと認証
{api_domain} はご利用のプラットフォームの API ドメインを使用します。リクエストは POST を使用し、body は JSON である必要があります。
三、リクエストパラメータ
3.1 共通パラメータ
string
必須
上記の表のモデル ID を使用します。
string
必須
画像の説明。中国語と英語に対応しています。
string / string[]
参照画像の URL または Base64 Data URL。1枚の画像または配列を渡せます。具体的な枚数と画像の制限は、選択したモデルの制限に従います。
string
モデルがサポートする解像度の段階または
幅x高さ。未指定の場合はモデルのデフォルト値を使用します。string
url または b64_json、デフォルトは url。string
Seedream 5.0 Lite と 5.0 Pro のみサポート：
jpeg または png。Seedream 4.0 と 4.5 は固定で JPEG を出力します。output_format を渡すと拒否されます。boolean
AI 生成の透かしを追加するかどうか。
boolean
画像インターフェースはストリーミング出力をサポートしていないため、
true を渡さないでください。3.2 モデル専用パラメータ
Seedream 5.0 Pro は
sequential_image_generation と sequential_image_generation_options をサポートしません。いずれかのフィールドを渡すと拒否されます。その他のモデルの専用パラメータは Pro に送信しないでください。
3.3 テキスト-to-画像の例
以下のリクエストは Seedream 5.0 Pro を例としています。4つのモデルは同じインターフェースを共有します。Seedream 4.0 または 4.5 を使用する場合はoutput_format を削除する必要があり、Seedream 5.0 Lite/Pro を使用する場合のみこのフィールドを渡せます。
3.4 画像-to-画像の例
image は、単一の URL、単一の Base64 Data URL、または文字列の配列にすることができます。
3.5 グループ画像の例（4.0、4.5、5.0 Lite のみ）
グループ画像パラメータは最初の3つのモデルに属します。例：四、レスポンス
成功レスポンスの例：response_format=urlの場合はdata[].urlを返し、response_format=b64_jsonの場合はdata[].b64_jsonを返します。- Seedream 4.0、4.5、5.0 Lite はグループ画像モードで複数の
data項目を返すことができます。 - Seedream 5.0 Pro は画像生成シナリオでは1つの
data項目を返し、レイヤー分割を有効にすると複数のdata項目（1つのベース画像 + 複数のレイヤー）を返します。各項目には追加でレイヤーの重ね順序z_index（ベース画像は0）、名前name、説明description、バウンディングボックスbounding_box（absolute / normalized 座標を含む、ベース画像はこのフィールドを返さない）が含まれます。 modelは今回のリクエストで使用されたクライアントモデル ID を返します。- 画像 URL の有効期限はプラットフォームと上流サービスによって決まりますので、返却後すぐに画像をダウンロードして保存してください。
五、モデル制限
Seedream 4.0 / 4.5 / 5.0 Lite
- テキスト-to-画像、画像-to-画像、グループ画像生成をサポートします。
- グループ画像は
sequential_image_generationとその options フィールドを使用します。 - 入力画像の枚数、画像サイズ、解像度、アスペクト比は、対応するモデルの上流ドキュメントに従ってください。Seedream 4.0 と 4.5 は固定で JPEG を出力し、リクエストパラメータ
output_formatをサポートしません。Seedream 5.0 Lite はjpegとpngをサポートします。
Seedream 5.0 Pro
- テキスト-to-画像、単一画像-to-画像、複数画像の融合をサポートします。
- 画像生成シナリオでは1つの成功画像を返します。レイヤー分割（
layer_decomposition: true）を有効にすると、1つのベース画像と複数のレイヤー（最大16レイヤー）を返し、その場合dataは複数項目になります。グループ画像生成（sequential_image_generation）はサポートしません。 sequential_image_generationとsequential_image_generation_optionsはサポートしません。sizeは 1K、1.5K、2K、または明示的な幅x高さを使用できます。- 明示的な幅高さの場合、アスペクト比と総ピクセル数はモデルの制限を満たす必要があります。出力画像の実際のサイズはレスポンスの
data[].sizeを基準とします。 - レイヤー分割をサポート：
layer_decomposition: trueを設定すると、1つの入力画像を1つのベース画像と最大16の独立して編集可能なレイヤー（各レイヤーはアルファチャンネル付きPNG）に分解します。このシナリオではimageは必須で1枚のみ渡せます。複数枚を渡すとエラーになります。レイヤー分割はオール・オア・ナッシングです：いずれかのレイヤーが失敗するとリクエスト全体が失敗し、部分的な成功はサポートされません。 - レイヤー分割の
sizeルール：ベース画像の解像度はsizeと等しくなります。各レイヤーの解像度はsizeに近くなりますが、各レイヤーは元の画像内の対応する領域のアスペクト比を維持するため、各レイヤーの実際のピクセル数は異なります。つまり、同じリクエストの出力画像が異なるピクセル価格帯に分類される可能性があります。sizeは 1K、1.5K、2K、auto から選択でき、デフォルトは auto です。
六、課金と使用量
- 4.0、4.5、5.0 Lite は正常に生成された画像の枚数に基づいて課金されます。グループ画像生成の場合は実際に成功した出力枚数に基づいて計算されます。
- 5.0 Pro は正常に出力された画像に基づいて課金されます。複数画像入力の場合、最初の参照画像は無料で、追加の参照画像は個別に計量されます。出力サイズが異なると、対応する価格帯も異なります。レイヤー分割を有効にすると、ベース画像と各レイヤーはそれぞれ1つの正常出力画像としてカウントされ、それぞれ
data[].sizeのピクセル数に応じて対応する価格帯に分類されて個別に課金されます（例えば、ベース画像は高ピクセル帯、一部のレイヤーは低ピクセル帯）。最終的な請求額は各価格帯の数の合計となります。 - 使用量の単位は「枚」または item です。
- 具体的な価格は、ご利用のプラットフォームの製品価格ページを参照してください。