申請プロセス
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-4-5-251128、doubao-seedream-4-0-250828、doubao-seedream-3-0-t2i-250415、doubao-seededit-3-0-i2i-250628をサポートしています。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は単一画像または複数画像の入力をサポート、doubao-seededit-3-0-i2i-250628は単一画像の入力のみをサポートし、doubao-seedream-3-0-t2i-250415はこのパラメータをサポートしていません。size：生成する画像のサイズ情報を指定します。以下の 2 つの方法をサポートし、混在させることはできません。方法 1 | 生成する画像の解像度を指定し、プロンプト内で自然言語で画像のアスペクト比を説明します。各モデルがサポートするプリセットは異なります：doubao-seedream-5-0-pro-260628は1K/2Kをサポート；doubao-seedream-5-0-260128は2K/3K/4Kをサポート；doubao-seedream-4-5-251128は2K/4Kのみをサポート；doubao-seedream-4-0-250828は1K/2K/4Kをサポート；doubao-seedream-3-0-t2i-250415とdoubao-seededit-3-0-i2i-250628はプリセットをサポートしておらず、方法 2 のみを受け入れます。 方法 2 | 生成する画像の幅と高さのピクセル値を指定します：デフォルトは2048x2048で、総ピクセル数と幅高さ比の範囲はモデルによって異なります（例えば、5.0 Pro の総ピクセル範囲は [921600, 4194304]、5.0 Lite / 4.5 の総ピクセル下限は 3,686,400、4.0 の下限は 921,600、3.0-t2i / seededit-3.0-i2i の範囲は [512x512, 2048x2048]）。seed：ランダム数シードで、モデルが生成する内容のランダム性を制御します。値の範囲は [-1, 2147483647] です。doubao-seedream-3-0-t2i-250415のみがこのパラメータをサポートします。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です。guidance_scale：モデルの出力結果とプロンプトの一致度。値が大きいほど関連性が強くなります。値の範囲は [1, 10] です。doubao-seedream-3-0-t2i-250415のデフォルト値は 2.5、doubao-seededit-3-0-i2i-250628のデフォルト値は 5.5、他のモデルはサポートしていません。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（オンライン検索）をサポートしています。doubao-seedream-5-0-260128のみがサポートしています。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-260128、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828は単一または複数の画像入力をサポートし、doubao-seededit-3-0-i2i-250628は単一画像入力のみをサポートします。 - image：編集する必要がある画像をアップロードします。1枚または複数枚。
非同期コールバック
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 インターフェースを呼び出してタスクの状態をポーリングし、最終結果を取得する必要があります。
以下の例を通じて、具体的にどのように操作するかを理解しましょう。
実行すると、すぐに結果が得られます。以下のようになります：
task_id フィールドが含まれており、他のフィールドは前述のものと似ています。このフィールドを通じてタスクの関連付けが可能です。
エラーハンドリング
APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：400 token_mismatched：不正なリクエスト、パラメータが不足しているか無効である可能性があります。400 api_not_implemented：不正なリクエスト、パラメータが不足しているか無効である可能性があります。401 invalid_token：未認証、無効または不足している認証トークン。429 too_many_requests：リクエストが多すぎます、レート制限を超えました。500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。