> ## Documentation Index > Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedream ## 一、概要 Seedream 画像生成 API は OpenAI スタイルの画像生成リクエスト形式を使用し、テキスト-to-画像、画像-to-画像、画像編集をサポートします。4つのモデルは同じインターフェースを使用し、クライアントはリクエスト body の model フィールドでモデルを選択するだけです。 ### サポートされるモデル | クライアントモデルID | モデル | 出力方法 | | ------------------------------ | ----------------- | ------------ | | `seedream-4-0-250828` | Seedream 4.0 | 単画像またはグループ画像 | | `seedream-4-5-251128` | Seedream 4.5 | 単画像またはグループ画像 | | `seedream-5-0-260128` | Seedream 5.0 Lite | 単画像またはグループ画像 | | `dola-seedream-5-0-pro-260628` | Seedream 5.0 Pro | 単画像またはレイヤー分割 | ## 二、インターフェースと認証 ```http theme={null} POST https://{api_domain}/v3/bytedance/api/v3/images/generations ``` リクエストヘッダー： ```http theme={null} Authorization: Bearer Content-Type: application/json ``` `{api_domain}` はご利用のプラットフォームの API ドメインを使用します。リクエストは POST を使用し、body は JSON である必要があります。 ## 三、リクエストパラメータ ### 3.1 共通パラメータ 上記の表のモデル ID を使用します。 画像の説明。中国語と英語に対応しています。 参照画像の URL または Base64 Data URL。1枚の画像または配列を渡せます。具体的な枚数と画像の制限は、選択したモデルの制限に従います。 モデルがサポートする解像度の段階または `幅x高さ`。未指定の場合はモデルのデフォルト値を使用します。 `url` または `b64_json`、デフォルトは `url`。 Seedream 5.0 Lite と 5.0 Pro のみサポート：`jpeg` または `png`。Seedream 4.0 と 4.5 は固定で JPEG を出力します。`output_format` を渡すと拒否されます。 AI 生成の透かしを追加するかどうか。 画像インターフェースはストリーミング出力をサポートしていないため、`true` を渡さないでください。 ### 3.2 モデル専用パラメータ | パラメータ | 使用可能なモデル | 説明 | | ------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `sequential_image_generation` | 4.0、4.5、5.0 Lite | グループ画像生成スイッチ。グループ画像が必要な場合は、対応するモデルの上流プロトコルに従って記入します。グループ画像を使用しない場合は省略します。 | | `sequential_image_generation_options` | 4.0、4.5、5.0 Lite | グループ画像生成オプション。`sequential_image_generation` と一緒に使用します。 | | `size` の 1K、1.5K、2K の段階 | 5.0 Pro | Pro はこれらの段階をサポートし、明示的な `幅x高さ` もサポートします。Pro はグループ画像パラメータをサポートしません。レイヤー分割シナリオでは段階（auto を含む）のみをサポートし、`layer_decomposition: true` で有効にします（モデル制限を参照）。 | 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 を使用する場合のみこのフィールドを渡せます。 ```bash theme={null} curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "model": "dola-seedream-5-0-pro-260628", "prompt": "雪山の湖のほとりにいる、赤いマフラーを巻いたゴールデンレトリバー、自然光、映画的な写真", "size": "2K", "response_format": "url", "output_format": "jpeg", "watermark": true }' ``` ### 3.4 画像-to-画像の例 `image` は、単一の URL、単一の Base64 Data URL、または文字列の配列にすることができます。 ```json theme={null} { "model": "seedream-4-5-251128", "prompt": "参照画像内の人物と服装を統一された都市夜景の中に配置し、人物の特徴を一致させる", "image": [ "https://example.com/person.png", "https://example.com/outfit.png" ], "size": "2560x1440", "response_format": "url" } ``` ### 3.5 グループ画像の例（4.0、4.5、5.0 Lite のみ） グループ画像パラメータは最初の3つのモデルに属します。例： ```json theme={null} { "model": "seedream-5-0-260128", "prompt": "統一スタイルの四季のポスターを3枚生成する", "sequential_image_generation": "auto", "sequential_image_generation_options": { "max_images": 3 }, "response_format": "url" } ``` 選択したモデルの上流プロトコルで、グループ画像パラメータの使用可能な値と枚数の制限を確認してください。 ## 四、レスポンス 成功レスポンスの例： ```json theme={null} { "created": 1786000000, "model": "seedream-4-5-251128", "data": [ { "url": "https://example.com/generated-image.jpeg", "size": "2560x1440", "output_format": "jpeg" } ], "usage": { "generated_images": 1, "input_images": 0 } } ``` * `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 です。 * 具体的な価格は、ご利用のプラットフォームの製品価格ページを参照してください。 ## 七、エラーのトラブルシューティング | シナリオ | 推奨事項 | | -------------------- | ----------------------------------------------------------------- | | モデルがサポートされていない | `model` が上記の表と完全に一致しているか確認してください。 | | prompt がない | body に空でないプロンプトを含める必要があります。 | | 画像が読み取れない | URL のアクセス可能性、形式、サイズ、ピクセル制限を確認してください。 | | `stream=true` | 画像インターフェースはストリーミング出力をサポートしていないため、このフィールドを削除するか `false` に設定してください。 | | Pro にグループ画像フィールドを渡した | 2つの `sequential_image_generation*` フィールドを削除してください。 | | size が無効 | 選択したモデルがサポートする段階、または制限を満たす `幅x高さ` を使用してください。 |