# Seedream 5.0 Pro (https://wanapi.app/zh-tw/docs/seedream-5-0-pro)
Seedream 5.0 Pro 可依提示詞生成一張圖片、編輯或結合最多 10 張參考圖片，也能將單張圖片分解為一張底圖與最多 16 個透明圖層。輸出可選擇 1K、1.5K、2K 或指定像素尺寸。[模型詳情與試驗區](/zh-tw/models/seedream-5-0-pro)。
## 連接 Wan API [#連接-wan-api]
使用 `https://api.wanapi.app` 作為 API 基底 URL。在 [API 金鑰設定](/zh-tw/settings/apikeys)中建立選用 **Wan** 模型系列的金鑰，並以 `Authorization: Bearer YOUR_API_KEY` 傳送。請將金鑰保存在伺服器端。試驗區使用您的網站登入工作階段，費用從同一帳號的餘額扣除。
`GET /v1/models` 會列出您的金鑰可使用的模型。Seedream 5.0 Pro 使用 OpenAI Images API：`POST /v1/images/generations` 接受 JSON，`POST /v1/images/edits` 則接受 JSON 或 multipart 上傳。圖片準備完成後即回傳請求結果，無須輪詢任務。
| 設定 | Seedream 5.0 Pro |
| ------- | ------------------------------------------------------------------------------------------ |
| 模型 ID | `bytedance/seedream-5.0-pro` |
| `size` | `1K`、`1.5K`、`2K`（預設），或使用 `WIDTHxHEIGHT` 指定尺寸，總像素數須介於 921,600–4,624,220，長寬比須介於 1:16 至 16:1。 |
| `image` | 最多 10 張參考圖片。 |
| 輸出 | 每次請求一張圖片；使用 `layer_decomposition` 時則為一張底圖與最多 16 個圖層。 |
## 生成圖片 [#生成圖片]
請在伺服器上將 `WAN_API_KEY` 設為您的金鑰。每次請求只送出一次；生成通常會在一分鐘內完成，因此請將用戶端逾時時間設為至少四分鐘。
```bash
curl https://api.wanapi.app/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
"size": "1K"
}'
```
回應採用 OpenAI Images 格式。以下範例值僅供示意：
```json
{
"created": 1792022400,
"data": [
{
"url": "https://cdn.example.com/image-1.jpg",
"size": "1024x1024",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1
}
}
```
圖片 URL 的有效期限為 30 天。若需保留更久，請自行儲存檔案。傳送 `"response_format": "b64_json"`，即可另外在 `b64_json` 中取得每張圖片的 Base64 資料。
## Seedream 5.0 Pro 價格 [#seedream-50-pro-價格]
每張生成圖片依自身像素尺寸計費，價格比官方費率低 30%：不超過 261 萬像素（1K 與 1.5K）採較低費率，更大的圖片採較高費率。第一張參考圖片免費，每多一張參考圖片會加收參考圖片費用。在圖片生成前就遭拒絕的請求不收費。
圖層分解會對底圖與每個回傳圖層計費。若每張回傳圖片都不超過 261 萬像素，每張價格比官方圖層費率低 30%。只要其中一張更大（`2K` 一定屬於此情況），所有圖片便各依自身尺寸採官方圖層費率。您的餘額須足以支付最多 17 張圖片的費用；僅對實際回傳的圖片收費。
## 請求欄位 [#請求欄位]
請傳送 JSON 物件。`model` 為必填；除非 `layer_decomposition` 為 `true`，否則 `prompt` 也為必填。不明欄位會遭拒絕。
| 欄位 | 型別 | 規範 |
| ------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | string | 必填：`bytedance/seedream-5.0-pro`。 |
| `prompt` | string | 要生成的內容，或圖層分解時要分離的元素。支援英文、中文與其他語言；保持在約 600 個英文單字以內可獲得最佳結果。 |
| `image` | string 或 string\[] | 最多 10 張參考圖片，使用 HTTP(S) URL 或 `data:image/;base64,...`，其中格式名稱須為小寫。格式：JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF；每張最多 30 MB；長寬比為 1:16 至 16:1。 |
| `size` | string | 圖片生成：`1K`、`1.5K`、`2K`（預設）或 `WIDTHxHEIGHT`。圖層分解：`1K`、`1.5K`、`2K` 或 `auto`（預設）。 |
| `layer_decomposition` | boolean | 預設為 `false`。`true` 會將一張 PNG 或 JPEG 圖片分解為一張底圖與最多 16 個圖層，且必須只提供一張圖片。 |
| `optimize_prompt_options` | object | `{"mode": "standard"}`（預設）或 `{"mode": "fast"}`。快速模式可縮短生成時間，但品質略低。 |
| `output_format` | string | `jpeg`（預設）或 `png`。圖層分解時，此欄位決定底圖格式；圖層一律為 PNG。 |
| `background` | string | `opaque`（預設）或 `transparent`。透明背景必須只使用一張具有 Alpha 色版的輸入圖片，並採 PNG 輸出；不能與圖層分解同時使用。 |
| `watermark` | boolean | 預設為 `true`：加入小型 AI 生成標籤。傳送 `false` 即可移除。 |
| `nsfw_checker` | boolean | 預設為 `true`，維持內容檢查開啟。`false` 會略過此檢查傳送請求；價格相同。 |
| `response_format` | string | `url`（預設）或 `b64_json`。 |
| `n` | integer | 選填；必須為 `1`。 |
此模型不支援 `stream`、`sequential_image_generation`、`tools`、`seed`、`guidance_scale` 與 `mask`，傳送這些欄位會遭拒絕。
## 編輯與結合參考圖片 [#編輯與結合參考圖片]
傳送一張圖片並附上編輯指示，或傳送多張圖片進行結合：
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
"image": [
"https://example.com/bottle.png",
"https://example.com/table.jpg"
],
"size": "2K",
"output_format": "png"
}
```
`POST /v1/images/edits` 接受相同欄位。使用 multipart 時，請透過 `image` 或 `image[]` 欄位上傳檔案，並將 `optimize_prompt_options` 以 JSON 字串傳送。
## 圖層分解 [#圖層分解]
```json
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "2K"
}
```
回應會先列出底圖。每個圖層另附堆疊順序、位置與說明：
```json
{
"created": 1792022400,
"data": [
{ "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://cdn.example.com/image-2.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
"name": "Title text",
"description": "Yellow serif title text"
}
],
"usage": { "input_images": 1, "generated_images": 2 }
}
```
任何一個圖層失敗，整個請求就會失敗。若提示詞要求的圖層數超過上限，部分圖層內容可能會被省略。
## 錯誤 [#錯誤]
錯誤採用 OpenAI 錯誤封裝格式 `{"error": {"message", "type", "code"}}`。
| HTTP | `code` | 意義 |
| ---- | -------------------------- | ---------------------------- |
| 400 | `invalid_request` 或驗證訊息 | 不支援某個欄位或組合。請修正請求；未收取任何費用。 |
| 400 | `content_policy_violation` | 提示詞、輸入圖片或輸出遭內容政策拒絕。未收取任何費用。 |
| 402 | insufficient quota | 再次送出前請先儲值。 |
| 429 | `rate_limited` | 請求過多。請稍後再試。 |
| 502 | `submission_unknown` | 未收到結果，且請求未收費。再次送出前，請先檢查用量記錄。 |
| 503 | `upstream_unavailable` | 圖片生成服務暫時無法使用；請求未收費。 |
請求逾時後，未先檢查用量記錄前，切勿自動重試。