優惠剩餘—Wan 模型最低 5.5 折,比官方價最多省 45%
LogoWan API
  • 模型
  • 開發者
  • 價格
  • API 文件
  • 指南
Seedream 5.5 API 教學:生成、編輯與拆解圖片
2026/11/12

Seedream 5.5 API 教學:生成、編輯與拆解圖片

提交一次 Seedream 5.5 請求並輪詢任務,以參考圖片編輯、製作透明 PNG 及拆解圖層。查看輸出尺寸與即時圖片價格。

Seedream 5.5 會先回傳任務 ID,再回傳圖片。提交一次請求、儲存 ID,再輪詢取得完成結果。圖片生成會產出一張圖片;圖層分解則可產出底圖與透明圖層。兩種流程都使用 model: "seedream-5-5",但輸入規則不同。1

本教學以陶瓷茶壺的創作說明示範圖片生成與指定編輯,再介紹如何將現有海報分解為圖層。Seedream 5.5 試驗區 提供相同的請求控制項。加入應用程式前,您可先在那裡檢查 JSON。

規範確認日期為 2026 年 11 月 12 日。我們的整合檢查重播了 34 個請求與回應案例,包括不相容的透明度設定、圖層限制,以及缺少可用尺寸的完成輸出。這些檢查驗證請求處理與計費輸入,並非生成速度或圖片品質的基準測試。以下圖片是 11 月 10 日既有的 Seedream 5.5 範例。

從金鑰與一個小型請求開始

在 API 金鑰 建立金鑰,將其保存在伺服器上,並使用 https://api.wanapi.app 作為基底 URL。現有的 Wan API 金鑰適用於所有可用模型與群組。使用此圖片模型無須另購或選擇專屬金鑰。

將以下內容儲存為 generate.json:

{
  "model": "seedream-5-5",
  "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
  "size": "1K",
  "output_format": "png",
  "content_filter": true
}

在伺服器環境中設定 WAN_API_KEY,再提交一次:

curl --fail-with-body --retry 0 --max-time 90 \
  https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @generate.json \
  -o submitted.json

成功回應包含 id、model 與處理中狀態。請保留完整的 submitted.json 檔案。沒有圖片 URL 不代表生成失敗:此回應表示任務已受理。若連線在收到 ID 前中斷,再次 POST 前請先檢查任務紀錄。回應不明確,並不代表可以再次建立相同的付費任務。

第一個請求明確選用了 1K。省略 size 時,圖片生成預設為 2K。預設格式為 PNG、浮水印關閉、內容審核開啟。公開 API 呼叫者可明確變更 content_filter;試驗區會為一般帳號維持審核開啟。1

輪詢已儲存的 ID,重新整理後也能繼續

輪詢 URL 為 GET /seedream55/v1/tasks/{id}。完成回應將圖片放在 output.data,並非使用同步 Images API 的回應結構。每個項目都有 URL 與實際像素尺寸。

此 Python 指令碼讀取已儲存的回應,並輪詢最多十分鐘。它只傳送 GET 請求,因此重新執行會繼續查詢既有任務:

import json
import os
import time
import urllib.error
import urllib.request
from pathlib import Path

saved = json.loads(Path("submitted.json").read_text())
task_id = saved["id"]
url = f"https://api.wanapi.app/seedream55/v1/tasks/{task_id}"
deadline = time.monotonic() + 600

while time.monotonic() < deadline:
    request = urllib.request.Request(
        url,
        headers={"Authorization": f"Bearer {os.environ['WAN_API_KEY']}"},
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            task = json.load(response)
    except urllib.error.HTTPError as error:
        if error.code != 429 and error.code < 500:
            raise
        time.sleep(5)
        continue
    except (urllib.error.URLError, TimeoutError):
        time.sleep(5)
        continue

    if task["id"] != task_id:
        raise RuntimeError("Unexpected task identity")
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "Task failed"))
    if task["status"] == "completed":
        Path("result.json").write_text(json.dumps(task, indent=2))
        for index, image in enumerate(task["output"]["data"], start=1):
            print(index, image["size"], image["url"])
        break
    time.sleep(5)
else:
    print("Still waiting. Keep submitted.json and resume this GET later.")

十分鐘限制屬於此範例用戶端。它不會取消任務,也無法證明生成失敗。我們尚未建立此整合的實測延遲範圍,因此應建立待處理狀態,而非承諾固定秒數。檔案準備好後請下載儲存;不要將結果 URL 視為永久素材儲存空間。

Seedream 5.5 生成的陶瓷狐狸茶壺,置於亞麻桌布上

此範例為 1248 × 832 像素。1K 預設尺寸代表解析度等級,不保證寬高都等於 1024。版面或費用計算需要確切尺寸時,請讀取結果中的 size。

改變場景並指定必須保留的內容

編輯時,請在 image 加入公開 HTTP(S) URL。這可以是您託管的原始照片,或下載後自行託管的生成檔案。參考圖片不能使用檔案上傳、Base64 或 data URI。處理請求期間,圖片必須持續可存取。支援的輸入格式與媒體限制列於 API 參考文件。1

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/fox-teapot.png",
  "prompt": "Keep the fox teapot, its curled tail, ceramic texture and camera angle. Replace the linen tablecloth with dark walnut wood. Keep the soft light coming from the left. No text.",
  "size": "1K"
}

上方 URL 為預留位置;請替換成可存取的圖片。請將它明確作為另一個獨立編輯任務提交,並以新檔名儲存回應。模型不會記得前一個任務:您必須傳送想要編輯的圖片。

多張參考圖片時,image 接受最多十個 URL 的陣列。在提示詞中指定每張圖片的用途,例如採用第一張的產品與第二張的場景。請先使用能滿足需求的最少張數。如果結果改變了重要細節,較少的參考圖片有助於找出是哪個指示或來源造成變化。

保留內容是一項指示,並不會鎖定像素。每次編輯後,請對照原圖檢查產品輪廓、標籤與鏡頭角度。製作海報時,將確切標題放在引號內,並以預定顯示尺寸檢查標點符號、名稱與日期。小字或風格化文字仍可能需要手動修正;本指南不承諾任何語言的實測準確率。

若要去背,請加入 "background": "transparent",並維持 "output_format": "png"。JPEG 無法承載該 Alpha 色版。透明度選項適用於生成與編輯;圖層模式有下方說明的專屬規則。

將海報分解為可重複使用的圖層

圖層分解必須只使用一張圖片。提示詞為選填:可省略讓模型選擇元素,或指定要分離的部分。評估設計時,請先使用較小的輸出上限:

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  },
  "output_format": "png"
}

max_images 也計入底圖。因此,四張代表底圖加上最多三個圖層。允許的上限為 2–100,預設為 30,模型可能回傳較少圖片。此模式請勿傳送 background,即使值為 auto 也不行。分解後的圖層本身即為透明 PNG;output_format 控制底圖。1

Seedream 5.5 海報原圖、分離的背景、樂手與透明文字圖層

此既有預覽結合了原始海報與回傳的透明元素。它有助於理解分解的意義,但不保證每張海報都會分解成相同數量的圖層,或具有乾淨的邊界。

請一併檢查每個結果的選填中繼資料:

欄位使用方式
z_index數值較高的圖層放在數值較低者上方。
bounding_box.absolute依底圖像素的左、上、右、下座標定位圖層。
bounding_box.normalized以 0–1000 尺度表示的對應座標。
name, description識別模型分離出的元素。
text_recognition讀取辨識文字、文字行與可用樣式資訊。

請保留完整結果 JSON,而不只是 URL。圖層圖片尺寸可能不同於其在底圖畫布上的擺放尺寸。重建構圖時請使用邊界框,並目視檢查結果。建議字型為估計值;OCR 中繼資料不保證能還原原始字型,也不代表能直接取得 PSD 檔案。藝術字、重疊元素及提示詞排除的文字,都可能使結果不完整。

比較費用前先選擇尺寸

圖片生成支援 1K、1.5K 與 2K,也支援總計 921,600–4,624,220 像素、長寬比為 1:16 至 16:1 的確切 WIDTHxHEIGHT 尺寸。圖層模式接受這些預設尺寸或 auto,但不接受確切尺寸。此規範不提供 3K 或 4K 預設尺寸、批次 n、種子值或快速提示詞最佳化模式。請勿未經核對就沿用其他 Seedream 版本的參數。1

以下目前費率與試驗區採用相同價格來源:

目前無法取得價格。請重新整理此頁再試一次。

費率會自動更新。一把 API 金鑰適用於所有模型與群組。

以 L 表示不超過 261 萬像素的輸出費率、H 表示超過此分界的費率、R 表示參考圖片費率。沒有參考圖片的 1K 生成費用為 L;使用一張參考圖片的編輯費用為 L + R。1K 與 1.5K 均採較低輸出費率。所有參考圖片均計費,包括第一張。2

要求四張圖片的 1K 圖層請求估價為 4L + R。若只回傳底圖與兩個圖層,且每張皆位於較低費率區間,最終費用為 3L + R。輸出尺寸混合時,請逐張計算:兩張較低費率區間圖片與一張較大圖片的費用為 2L + H + R。底圖也是輸出圖片,不得漏算。

初始預扣涵蓋所選上限。實際輸出結算後會釋放未使用款項,失敗任務則會退款。在我們的計費測試中,重播相同的完成回應不會再次變動餘額。我們也確認,若完成回應缺少任何必要的圖片用量資料,就會維持未結算,而非把估計數量當成實際觀察到的輸出。

請求或結果需要處理時

驗證錯誤通常指向模式不相符:例如圖層模式使用多張參考圖片、透明 JPEG、不支援的尺寸,或在生成請求使用圖層選項。建立新任務前,請先修正請求。暫時性的輪詢錯誤則不同:請保留既有 ID 並重試 GET。這是兩種不同決策,若合併成通用的「全部重試」處理方式,可能造成重複付費生成。

編輯效果不佳時,請每次只比較一項變動,並對照原圖。較大輸出並不能證明模型有正確保留標籤或呈現標題。圖層結果匯入正式設計前,請檢查邊緣與缺少的中繼資料。內容審核預設維持開啟;內容遭拒絕時,不應自動關閉審核後重新提交。

Seedream 5.5 適合在此規範下需要生成、參考圖片編輯或可分離設計元素的流程。Seedream 5.0 Pro 是另一個模型,預設值與限制不同。我們未進行可支持某一款始終較佳之主張的對照比較。本指南也未另行宣稱提供「5.5 Pro」,或承諾免費生成。請查看模型頁 確認目前試驗區與價格,或使用 OpenAPI 文件 在應用程式中建立請求驗證。

參考資料

  1. Seedream 5.5 API 參考文件:請求欄位、預設值、URL 輸入、非同步回應與圖層中繼資料。規範確認日期:2026 年 11 月 12 日。
  1. Seedream 5.5 即時價格:輸出像素區間與參考圖片費率。
所有文章

作者

avatar for Wan API
Wan API

分類

  • 產品
從金鑰與一個小型請求開始輪詢已儲存的 ID,重新整理後也能繼續改變場景並指定必須保留的內容將海報分解為可重複使用的圖層比較費用前先選擇尺寸請求或結果需要處理時參考資料

更多文章

Seedream 5.0 Pro 圖層分解:回傳內容與計費方式
產品

Seedream 5.0 Pro 圖層分解:回傳內容與計費方式

瞭解 Seedream 5.0 Pro API 圖層分解的輸入規則、尺寸選項與回傳的圖層資料,並在執行前確認每個圖層的計費方式。

avatar for Wan API
Wan API
2026/10/23
Seedance 2.5 與 2.0:哪款適合您的場景?
產品

Seedance 2.5 與 2.0:哪款適合您的場景?

比較 Seedance 2.5 與 2.0 的影片長度、參考素材上限與範例設定,規劃條件一致的測試,不預設畫質或速度的優勝者。

avatar for Wan API
Wan API
2026/10/14
Seedance 2.0 Fast 與 Mini:該測試哪款?
產品

Seedance 2.0 Fast 與 Mini:該測試哪款?

比較 Seedance 2.0 Fast 與 Mini 的限制、參考影片計費及範例場景。以相同創作說明測試品質、耗時與可用鏡頭成本。

avatar for Wan API
Wan API
2026/10/15

Wan API 最新消息

服務更新與模型消息

訂閱以接收模型消息、服務更新與 API 整合資訊。

LogoWan API

Wan 3.0 與 Wan 3.0 Prime。 為您的下一個專案生成影片。獨立平台,與 Alibaba、Wan 或 ByteDance 無隸屬關係,亦未獲其背書。

X (Twitter)
Featured on Findly.toolsFazierDang.aiFeatured on Twelve Tools
模型
  • Wan 3.0
  • Wan 3.0 Prime
  • Wan 3.0 Pro
  • Wan 3.0 Prime Pro
  • Seedance 2.5
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • Seedance 2.5 Flash
  • Seedream 5.0 Pro
  • Seedream 5.5
  • Claude Haiku 5.5
  • Claude Sonnet 5.5
  • Claude Opus 5.5
  • Claude Fable 5.2
  • GPT Luna 6
  • GPT Terra 6.1
  • GPT Sol 6.1
  • GPT Astra 6
  • 價格
開發者
  • 技術文件
  • Wan 3.0 指南
  • 常見問題
  • 關於 Wan API
  • 聯絡 Wan API
法律資訊
  • 隱私權
  • 條款
llms.txtllms-full.txtsitemap.xml
© 2026 Wan API. 保留所有權利。