LogoWan API 文件
首頁
X (Twitter)
首頁

快速開始

總覽整合指南查詢餘額刪除任務

Wan 模型

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance 模型

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

圖片模型

Seedream 5.0 ProSeedream 5.5 API

語言模型

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

Seedream 5.5 API

使用 Seedream 5.5 生成與編輯圖片,或拆解圖層。查看請求參數、非同步任務、圖片中繼資料及目前每張圖片費率。

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

試用試驗區 · OpenAPI JSON · 整合教學

驗證與端點

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

方法URL用途
POSThttps://api.wanapi.app/seedream55/v1/images/generations提交一個圖片任務
GEThttps://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字串生成時必填圖層分解時為選填。
imageURL 或 URL 陣列無最多 10 張參考圖片;圖層分解必須只用一張。每張參考圖片皆計費。
size字串2K,圖層則為 auto請見下方尺寸規則。
output_format字串pngpng 或 jpeg。圖層模式僅控制底圖。
background字串autoauto、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 並繼續查詢。

Seedream 5.0 Pro

Seedream 5.0 Pro API 參考文件:文字生成圖片、參考圖片編輯、圖層分解、透明 PNG、請求欄位、回應與價格。

Claude API

透過 Anthropic Messages 或 OpenAI Chat Completions 呼叫 Claude。查看模型 ID、串流範例,以及各分組的即時輸入、輸出與快取價格。

目錄

驗證與端點生成圖片參數輸出尺寸參考圖片與編輯圖層分解與文字辨識完成回應價格錯誤與重試行為