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





Seedream 5.5 可依文字或最多 10 張參考圖片生成一張圖片。圖層分解接受一張圖片，回傳底圖與透明圖層，並可選擇取得印刷文字辨識結果。

[試用試驗區](/zh-tw/models/seedream-5-5#playground) · [OpenAPI JSON](/models/seedream-5-5/openapi.json) · [整合教學](/zh-tw/blog/seedream-5-5-api-guide)

## 驗證與端點 [#驗證與端點]

使用 Wan API 金鑰作為 Bearer 權杖。一把金鑰可存取所有可用模型與群組；無須在金鑰上選擇群組。

| 方法   | URL                                                       | 用途       |
| ---- | --------------------------------------------------------- | -------- |
| POST | `https://api.wanapi.app/seedream55/v1/images/generations` | 提交一個圖片任務 |
| 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`                                        | 字串           | 必填               | `seedream-5-5`                                           |
| `prompt`                                       | 字串           | 生成時必填            | 圖層分解時為選填。                                                |
| `image`                                        | URL 或 URL 陣列 | 無                | 最多 10 張參考圖片；圖層分解必須只用一張。每張參考圖片皆計費。                        |
| `size`                                         | 字串           | `2K`，圖層則為 `auto` | 請見下方尺寸規則。                                                |
| `output_format`                                | 字串           | `png`            | `png` 或 `jpeg`。圖層模式僅控制底圖。                                |
| `background`                                   | 字串           | `auto`           | `auto`、`opaque`、`transparent`。透明背景必須使用 PNG。圖層模式請完全省略此欄位。 |
| `layer_decomposition`                          | 布林值          | `false`          | 將一張參考圖片拆解為底圖與透明 PNG 圖層。                                  |
| `layer_decomposition_options.max_images`       | 整數           | `30`             | 圖片總數上限為 2–100，包含底圖。僅適用於圖層模式。                             |
| `layer_decomposition_options.text_recognition` | 布林值          | `false`          | 要求圖層中的印刷文字中繼資料。僅適用於圖層模式。                                 |
| `optimize_prompt_options.mode`                 | 字串           | `standard`       | 唯一支援的模式為 `standard`。                                     |
| `watermark`                                    | 布林值          | `false`          | 要求加入 AI 生成浮水印。                                           |
| `content_filter`                               | 布林值          | `true`           | 客戶 API 接受 false。試驗區僅允許管理員停用。                             |

不支援 `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，每張圖片最多 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 陣列，並在提示詞中說明每張圖片的用途。結果仍為一張圖片。範例中的參考 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` 代表最多回傳四張圖片，而非四個圖層加一張底圖。模型可能回傳較少圖片。省略 `prompt` 可自動分解，也可指定要分離的元素。提示詞可能抑制其中排除的文字。

圖層為含透明度的 PNG 檔案。請依 `z_index` 遞增順序重建圖片，底圖為 0。若有提供邊界框，請先將圖層調整至該框的尺寸，再進行定位：圖層檔案的像素尺寸可能與其擺放尺寸不同。

選填的 `text_recognition` 包含完整 `text` 與 `lines`。每行可包含 `bounding_box` 與帶有樣式的 `runs`。文字片段的 `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
```

每張參考圖片皆計費，包括第一張與圖層分解的原始圖片。圖片生成與圖層分解採相同輸出費率。提交時預扣一張輸出，或圖層 `max_images` 上限，再加上參考圖片。完成時計算每張回傳圖片自身的像素尺寸，並釋放未使用的預扣金額。即使執行期間費率改變，已受理任務仍保留原價格快照。失敗任務會退款。

## 錯誤與重試行為 [#錯誤與重試行為]

無效參數會在提交前遭拒絕。餘額或金鑰配額不足時無法生成。提交與輪詢都會進行驗證及擁有權檢查。失敗任務會回傳 `status: "failed"` 及 `error` 物件。

狀態讀取失敗時，請使用同一任務 ID 重試。**請勿自動重複生成 POST**，包括逾時後：請求可能已受理。只要上游回報正常進度，任務就會維持待處理。若連續三小時沒有正常上游狀態或成功交付，任務會失敗並退款。

請參閱 [Seedream 5.5 教學](/zh-tw/blog/seedream-5-5-api-guide)，了解如何在應用程式迴圈中儲存任務 ID 並繼續查詢。
