Seedream 5.5 API
使用 Seedream 5.5 生成與編輯圖片,或拆解圖層。查看請求參數、非同步任務、圖片中繼資料及目前每張圖片費率。
Seedream 5.5 可依文字或最多 10 張參考圖片生成一張圖片。圖層分解接受一張圖片,回傳底圖與透明圖層,並可選擇取得印刷文字辨識結果。
試用試驗區 · OpenAPI JSON · 整合教學
驗證與端點
使用 Wan API 金鑰作為 Bearer 權杖。一把金鑰可存取所有可用模型與群組;無須在金鑰上選擇群組。
| 方法 | URL | 用途 |
|---|---|---|
| POST | https://api.wanapi.app/seedream55/v1/images/generations | 提交一個圖片任務 |
| 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 | 字串 | 必填 | 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 預設尺寸。
參考圖片與編輯
請提供由您自行託管、不含嵌入憑證的公開 HTTP(S) URL。支援 JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC 與 HEIF,每張圖片最多 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 陣列,並在提示詞中說明每張圖片的用途。結果仍為一張圖片。範例中的參考 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 代表最多回傳四張圖片,而非四個圖層加一張底圖。模型可能回傳較少圖片。省略 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。這些是模型估計值。藝術字或手寫字可能沒有文字結果;請將此欄位視為選填。
完成回應
{
"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) | US$0.017 |
| 超過 2.61 MP 的輸出(2K) | US$0.02975 |
| 每張參考圖片,包含第一張 | US$0.0068 |
費率會自動更新。一把 API 金鑰適用於所有模型與群組。
輸出像素分界為 2,610,000 像素。費用計算方式如下:
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 教學,了解如何在應用程式迴圈中儲存任務 ID 並繼續查詢。