申請プロセス
SeeDream Images Generation API を使用するには、まず Ace Data Cloud コンソール にアクセスして、API トークンを取得し、保管してください。
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。
1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般残高をチャージできます。
📘 完全なドキュメント：SeeDream Images Generation API →
基本使用
まず、基本的な使用方法を理解します。これは、プロンプトprompt、生成行動 action、画像サイズ size を入力することで、処理された結果を得ることができます。最初に、action フィールドを単純に渡す必要があり、その値は generate です。その後、プロンプトを入力する必要があります。具体的な内容は以下の通りです：
accept：受け取りたいレスポンス結果の形式。ここではapplication/json、つまり JSON 形式を記入します。authorization：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
prompt：プロンプト。model：生成モデル。デフォルトはdoubao-seedream-5-0-260128（SeeDream 5.0 Lite、最新）。doubao-seedream-5-0-pro-260628、doubao-seedream-5-0-260128（公式の別名doubao-seedream-5-0-lite-260128も受け入れられます）、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828をサポートしています。doubao-seedream-5-0-pro-260628（SeeDream 5.0 Pro）はフラッグシップの単一画像モデルで、単一画像のみを生成し、グループ画像（sequential_image_generation）、ストリーミング（stream）、およびネット検索（tools）はサポートしていません。modelには完全なモデル文字列（例：doubao-seedream-5-0-260128）を渡す必要があり、doubao-seedream-5.0-liteのような省略形を渡すと 400 が返されます。image：入力する画像情報。URL または Base64 エンコードをサポートします。doubao-seedream-5-0-pro-260628は単一画像または複数画像の入力をサポート（複数画像は 2-10 枚、2 枚目以降は枚数に応じて課金）、doubao-seedream-5-0-260128、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828は単一画像または複数画像の入力をサポートします。size：生成する画像のサイズ情報を指定します。以下の 2 つの方法をサポートし、混用はできません。方法 1 | 生成する画像の解像度を指定し、プロンプト内で自然言語で画像のアスペクト比を説明します。各モデルがサポートするプリセットは異なります：doubao-seedream-5-0-pro-260628は1K/1.5K/2Kをサポート；doubao-seedream-5-0-260128は2K/3K/4Kをサポート；doubao-seedream-4-5-251128は2K/4Kのみをサポート；doubao-seedream-4-0-250828は1K/2K/4Kをサポート。方法 2 | 生成する画像の幅と高さのピクセル値を指定します：デフォルトは2048x2048で、総ピクセル数とアスペクト比の値の範囲はモデルによって異なります（例えば、5.0 Pro の総ピクセル範囲は [921600, 4624220]、5.0 Lite / 4.5 の総ピクセル下限は 3,686,400、4.0 の下限は 921,600）。sequential_image_generation：グループ画像：入力した内容に基づいて生成される一連の関連画像。doubao-seedream-5-0-260128、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828はこのパラメータをサポートし、デフォルトはdisabledです。stream：ストリーミング出力モードを有効にするかどうかを制御します。doubao-seedream-5-0-260128、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828はこのパラメータをサポートし、デフォルトはfalseです。response_format：生成された画像の返却形式を指定します。デフォルトはurlで、b64_jsonもサポートしています。watermark：生成された画像にウォーターマークを追加するかどうか。デフォルトはtrueです。output_format：生成された画像のファイル形式を指定します。jpeg（デフォルト）およびpngをサポート。doubao-seedream-5-0-pro-260628とdoubao-seedream-5-0-260128のみサポート。tools：モデルが呼び出すツールを設定します。現在、web_search（ネット検索）をサポートしています。Seedream 5.0 Lite のみサポート。optimize_prompt_options：プロンプト最適化設定。5.0 Pro はstandard/fastをサポート；5.0 Lite と 4.5 はstandardのみサポート；4.0 はstandard/fastをサポート。background：5.0 Pro のみ単一画像編集をサポート。transparentは透明チャンネルを持つ PNG を入力する必要があり、output_formatはpngでなければなりません；opaqueは通常の不透明背景です。layer_decomposition：5.0 Pro のみサポート。trueに設定すると、PNG/JPEG を入力する必要があり、promptを渡さずに自動的に分解するか、自然言語/<bbox>で要素を指定します；sizeはauto/1K/1.5K/2Kをサポート。このモードはグループ画像、ストリーミング、ネット検索、またはbackgroundと同時に使用できません。callback_url：結果をコールバックするための URL。async：非同期モードで処理するかどうか。trueに設定すると、インターフェースはすぐにtask_idを返し、callback_urlを提供する必要はなく、その後/seedream/tasksを通じて結果をポーリングして取得します。
success、この時のビデオ生成タスクの状態。task_id、この時のビデオ生成タスク ID。trace_id、この時のビデオ生成トレース ID。data、この時の画像生成タスクの結果リスト。image_url、この時の画像生成タスクのリンク。prompt、プロンプト。size: 生成された画像のピクセル
data の画像リンクアドレスに基づいて生成された SeeDream 画像を取得するだけです。
また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURL のコードは以下の通りです：
画像編集タスク
特定の画像を編集したい場合、まずパラメータimage に編集する必要がある画像のリンクを渡す必要があります。
- model：今回の画像編集タスクで使用されるモデル、
doubao-seedream-5-0-pro-260628、doubao-seedream-5-0-260128、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828はすべて画像入力をサポートしています。 - image：編集する必要がある画像をアップロード、一枚または複数枚
レイヤー分解（Seedream 5.0 Pro）
レイヤー分解は、入力画像を1枚のベース画像と最大16枚の独立して編集可能な透明PNGレイヤーに分解します。以下のリクエストは、モデルが主要な要素を自動的に認識するようにします。要素を指定する必要がある場合は、promptを追加するか、プロンプト内で正規化された <bbox> 座標を使用できます。
data は z_index に従って底から上に並べられます。ベース画像の z_index は0です；レイヤーには name、description、および bounding_box.absolute/normalized が含まれます。絶対座標で再構成する際は、レイヤーを [right-left, bottom-top] にスケーリングし、[left, top] に配置し、z_index の昇順で重ねます。いずれかのレイヤーの生成が失敗した場合、全体の分解が失敗します。
ストリーミング出力
Lite/4.x でstream: true を設定した場合、リクエストヘッダーは accept: application/x-ndjson を使用します。インターフェースは逐次的に image_generation.partial_succeeded または image_generation.partial_failed を返し、最後にユニークな image_generation.completed イベントと最終的な usage を返します；完了イベントが一度トリガーされると課金されます。ストリーミングモードは async または callback_url と同時に使用できません。
非同期コールバック
SeeDream Images Generation API の生成時間は比較的長く、約1〜2分かかるため、APIが長時間応答しない場合、HTTPリクエストは接続を維持し、追加のシステムリソースを消費する可能性があります。そのため、このAPIは非同期コールバックのサポートも提供しています。 全体の流れは：クライアントがリクエストを開始する際に、追加でcallback_url フィールドを指定します。クライアントがAPIリクエストを開始した後、APIはすぐに結果を返し、現在のタスクIDを示す task_id フィールド情報を含みます。タスクが完了すると、生成された画像の結果がPOST JSON形式でクライアントが指定した callback_url に送信され、その中にも task_id フィールドが含まれます。これにより、タスク結果をIDで関連付けることができます。
もしコールバック用のパブリックアドレスがない場合は、callback_url を指定せず、リクエスト内で async フィールドを true に設定することもできます。この場合、インターフェースは同様にすぐに task_id を返しますが、結果はプッシュされず、その task_id を持って /seedream/tasks インターフェースを呼び出してタスクの状態をポーリングし、最終結果を取得する必要があります。
以下の例を通じて、具体的にどのように操作するかを理解しましょう。
実行すると、すぐに結果が得られます。以下のようになります：
400 token_mismatched：不正なリクエスト、パラメータが欠落または無効である可能性があります。400 api_not_implemented：不正なリクエスト、パラメータが欠落または無効である可能性があります。401 invalid_token：未承認、無効または欠落した認証トークン。429 too_many_requests：リクエストが多すぎます、レート制限を超えました。500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。