# Seedream 5.5 API (https://wanapi.app/ja/docs/seedream-5-5)





Seedream 5.5 はテキストまたは最大 10 枚の参照画像から画像を 1 枚生成します。レイヤー分解では 1 枚の画像からベース画像と透明レイヤーを返し、任意で印刷文字の認識結果も取得できます。

[Playground で試す](/ja/models/seedream-5-5#playground) · [OpenAPI JSON](/models/seedream-5-5/openapi.json) · [連携チュートリアル](/ja/blog/seedream-5-5-api-guide)

## 認証とエンドポイント [#認証とエンドポイント]

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 は &#x2A;*`seedream-5-5`** です。これらは非同期エンドポイントです。一度送信し、タスク ID を保存して、`completed` または `failed` になるまでポーリングしてください。ネットワークの応答が不明確でも、再送信してよいという意味にはなりません。

## 画像を生成する [#画像を生成する]

```bash
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"
  }'
```

受理されたリクエストは画像データではなくタスクを返します。

```json
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
```

```bash
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 プリセットはありません。

<span id="reference-images-and-editing" />

## 参照画像と編集 [#参照画像と編集]

認証情報を含まない、ご自身でホストする公開 HTTP(S) URL を指定してください。対応形式は JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF で、画像 1 枚あたり最大 30 MB、合計最大 36,000,000 ピクセルです。AVIF と JP2 は非対応です。URL はログインやブラウザーの検証画面なしで画像を直接配信する必要があります。

```json
{
  "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 はプレースホルダーなので、ご自身のアクセス可能なファイルに置き換えてください。

## レイヤー分解と文字認識 [#レイヤー分解と文字認識]

```json
{
  "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` が含まれる場合があります。これらはモデルによる推定です。装飾文字や手書き文字では認識結果がないこともあるため、任意の項目として扱ってください。

## 完了時のレスポンス [#完了時のレスポンス]

```json
{
  "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 キーを公開せずに開けます。

## 料金 [#料金]

<Seedream55ModelPricing />

出力のピクセル数の境界は **2,610,000 ピクセル** です。料金は次のように計算します。

```text
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 チュートリアル](/ja/blog/seedream-5-5-api-guide)をご覧ください。
