Seedream 5.5 API
Seedream 5.5 で画像生成・編集・レイヤー分解。リクエスト項目、非同期タスク、画像メタデータ、現在の画像単価を解説します。
Seedream 5.5 はテキストまたは最大 10 枚の参照画像から画像を 1 枚生成します。レイヤー分解では 1 枚の画像からベース画像と透明レイヤーを返し、任意で印刷文字の認識結果も取得できます。
Playground で試す · OpenAPI JSON · 連携チュートリアル
認証とエンドポイント
Wan API キーを Bearer トークンとして使用します。1 つのキーですべての利用可能なモデルとグループにアクセスでき、キーでグループを選択する必要はありません。
| メソッド | URL | 用途 |
|---|---|---|
| POST | https://api.wanapi.app/seedream55/v1/images/generations | 画像タスクを 1 件送信 |
| GET | https://api.wanapi.app/seedream55/v1/tasks/{id} | そのタスクを取得 |
モデル ID は seedream-5-5 です。これらは非同期エンドポイントです。一度送信し、タスク ID を保存して、completed または failed になるまでポーリングしてください。ネットワークの応答が不明確でも、再送信してよいという意味にはなりません。
画像を生成する
curl https://api.wanapi.app/seedream55/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-5",
"prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
"size": "1K"
}'受理されたリクエストは画像データではなくタスクを返します。
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
-H "Authorization: Bearer $WAN_API_KEY"数秒おきに同じ ID をポーリングします。アプリが待機を停止しても、後から再開できるよう ID を保存してください。このガイドのタスク ID とタイムスタンプは説明用の例です。
パラメーター
| パラメーター | 型 | 既定値 | 規則 |
|---|---|---|---|
model | string | 必須 | seedream-5-5 |
prompt | string | 画像生成では必須 | レイヤー分解では任意。 |
image | URL または URL 配列 | なし | 参照画像は最大 10 枚、レイヤー分解ではちょうど 1 枚。すべての参照画像が課金対象。 |
size | string | 2K、レイヤーでは auto | 下記のサイズ規則を参照。 |
output_format | string | png | png または jpeg。レイヤーではベース画像のみに適用。 |
background | string | auto | auto、opaque、transparent。透明背景には PNG が必要。レイヤーモードではこの項目を完全に省略。 |
layer_decomposition | boolean | false | 参照画像 1 枚をベース画像と透明 PNG レイヤーに分解。 |
layer_decomposition_options.max_images | integer | 30 | ベース画像を含む合計画像数の上限、2–100。レイヤーモードのみ。 |
layer_decomposition_options.text_recognition | boolean | false | レイヤー内の印刷文字メタデータを要求。レイヤーモードのみ。 |
optimize_prompt_options.mode | string | standard | 対応するモードは standard のみ。 |
watermark | boolean | false | AI 生成を示す透かしを要求。 |
content_filter | boolean | true | 顧客 API は false を受け付けます。Playground では管理者のみ無効にできます。 |
n、seed、stream、resolution、aspect_ratio、image_urls、response_format パラメーターには対応していません。未記載の項目は破棄され、これらの機能を有効にはしません。multipart アップロード、Base64、data URI は拒否されます。
出力サイズ
画像生成は 1K、1.5K、2K または正確な WIDTHxHEIGHT ピクセル指定に対応します。正確なサイズは合計 921,600–4,624,220 ピクセル、アスペクト比 1:16–16:1 の範囲にする必要があります。たとえば 2048x1152 は有効です。16:9 のような比率はサイズの値ではありません。
レイヤー分解は auto、1K、1.5K、2K に対応し、正確なピクセル指定には対応しません。auto は入力に合わせ、高い出力単価で仮引き落としします。3K・4K プリセットはありません。
参照画像と編集
認証情報を含まない、ご自身でホストする公開 HTTP(S) URL を指定してください。対応形式は JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF で、画像 1 枚あたり最大 30 MB、合計最大 36,000,000 ピクセルです。AVIF と JP2 は非対応です。URL はログインやブラウザーの検証画面なしで画像を直接配信する必要があります。
{
"model": "seedream-5-5",
"prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
"image": "https://your-cdn.example/lighthouse.jpg",
"size": "2K"
}複数の参照画像は URL 配列で渡し、プロンプトで各画像の役割を説明します。その場合も結果は画像 1 枚です。例の参照 URL はプレースホルダーなので、ご自身のアクセス可能なファイルに置き換えてください。
レイヤー分解と文字認識
{
"model": "seedream-5-5",
"image": "https://your-cdn.example/poster.png",
"size": "1K",
"layer_decomposition": true,
"layer_decomposition_options": {
"max_images": 4,
"text_recognition": true
}
}上限にはベース画像を含みます。4 は返される画像が最大 4 枚という意味で、4 レイヤーとベース画像ではありません。返される枚数はそれより少ない場合があります。自動分解では prompt を省略するか、分解したい要素を指定してください。プロンプトで除外した文字は出力されないことがあります。
レイヤーは透明部分を持つ PNG ファイルです。ベースを 0 として、z_index の昇順に重ねて画像を再構成します。バウンディングボックスがあれば、配置前にその寸法にレイヤーをリサイズしてください。レイヤーファイルのピクセル寸法と配置寸法は異なる場合があります。
任意の text_recognition には全文の text と lines が含まれます。各行には bounding_box とスタイル付きの runs が含まれる場合があります。各 run の style には similar_font_family、foreground_color(#RRGGBB)、bold、italic、underline、strikethrough、shadow、translucent が含まれる場合があります。これらはモデルによる推定です。装飾文字や手書き文字では認識結果がないこともあるため、任意の項目として扱ってください。
完了時のレスポンス
{
"id": "task_example",
"model": "seedream-5-5",
"status": "completed",
"created_at": 1794432000,
"output": {
"data": [
{
"url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
"size": "1248x832",
"output_format": "png"
}
]
}
}各画像には url と size があります。ほかに output_format、background、z_index、name、description、bounding_box、text_recognition が含まれる場合があります。bounding_box.absolute はベース画像のピクセル単位の [left, top, right, bottom] です。bounding_box.normalized は同じ座標を 0–1000 に換算した値です。任意のメタデータがすべての画像にあると仮定しないでください。
画像 URL は非公開のダウンロードリンクとして扱い、必要なファイルを保存してください。access トークン付き URL はアカウントの API キーを公開せずに開けます。
料金
| 課金対象画像 | USD / 枚 |
|---|---|
| 2.61 MP 以下の出力(1K / 1.5K) | $0.017 |
| 2.61 MP を超える出力(2K) | $0.02975 |
| 最初の 1 枚を含むすべての参照画像 | $0.0068 |
単価は自動更新されます。1 つの API キーですべてのモデルとグループを利用できます。
出力のピクセル数の境界は 2,610,000 ピクセル です。料金は次のように計算します。
lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate最初の 1 枚やレイヤー用の元画像を含め、すべての参照画像が課金対象です。画像生成とレイヤー分解には同じ出力単価を使います。送信時は出力 1 枚、またはレイヤーの max_images 上限と参照画像分を仮引き落としします。完了時は返された各画像自体のピクセル寸法で精算し、未使用分を戻します。実行中に単価が変わっても、受理されたタスクは受付時の料金を保持します。失敗したタスクは返金されます。
エラーと再試行
無効なパラメーターは送信前に拒否されます。残高やキーのクォータが不足すると生成できません。送信とポーリングの両方に認証と所有権の確認が適用されます。失敗したタスクは status: "failed" と error オブジェクトを返します。
ステータス取得に失敗した場合は同じタスク ID で再試行します。タイムアウト後も含め、生成 POST を自動で繰り返さないでください。既に受理されている可能性があります。上流が正常な進行状況を返す間はタスクを待機状態に保ちます。正常な上流ステータスも正常な配信も連続 3 時間ないタスクは失敗となり、返金されます。
タスク ID を保存して再開するアプリのループは、Seedream 5.5 チュートリアルをご覧ください。