wan2.7-image-pro API

使用準確的型號 ID wan2.7-image-pro。模型欄位必須與此頁面完全相符。

範例輸出wan2.7-image-proPOST /v1/images/generations

參數： size=2Kn=1

提示詞： Modern poster in Chinese ink-wash style: layered misty mountains, a lone wooden boat on a still river, a single red seal-like accent, generous negative space, elegant and minimal, no text.

產生此樣本的請求

{
  "model": "wan2.7-image-pro",
  "prompt": "Modern poster in Chinese ink-wash style: layered misty mountains, a lone wooden boat on a still river, a single red seal-like accent, generous negative space, elegant and minimal, no text.",
  "n": 1,
  "size": "2K"
}

身份驗證與端點

將 Modelflare API 金鑰與 https://modelflare.dev/v1 結合使用。網關入口點是POST /v1/images/generations。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

生成影像

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

請求備註

OpenAI相容的影像模型使用prompt、n、size和quality；僅在官方頁面記錄時才使用編輯。

請求參數

Wan2.7 Image / Pro 使用同步影像 API。使用相容 OpenAI 的扁平形狀進行簡單呼叫；使用 input.messages 和 parameters 進行多圖像、區域編輯和順序生成。 Pro文字轉影像最高支援4K外序模式；標準型號最高支援2K。

場	必填	註釋
model	是	wan2.7-image-pro
prompt	是	產生或編輯指令
image	否	單圖 URL/Base64；使用 input.messages 最多可拍攝 9 張影像
input.messages	否	用於多圖像、區域編輯和順序生成的嵌套訊息
size	否	1K / 2K; Pro非順序文字轉影像也支援4K
n	否	1-4為普通一代；1–12 用於順序生成；按成功圖像計費
thinking_mode	否	無影像時的思考模式
watermark	否	是否添加浮水印
parameters.prompt_extend	否	提示擴展，預設true；
parameters.bbox_list	否	互動式編輯區域框
parameters.enable_sequential	否	啟用順序生成
parameters.color_palette	否	3–10 種十六進位顏色，百分比總計為 100%

回應與輸入限制

使用扁平形狀進行簡單呼叫；使用input.messages和parameters進行多圖像、區域編輯和順序生成。最多支援 9 個輸入影像，每個影像小於 20 MB，每邊 240–8,000 像素，長寬比為 1:8 到 8:1。普通輸出計數為1-4，順序輸出計數為1-12； Pro 文字轉影像支援 4K 外部順序模式，而其他組合最高可達 2K。

記錄的工作流程範例

Wan2.7影像既支援平面形狀，也支援嵌套的input.messages/parameters形狀；使用嵌套形狀進行多重影像、區域編輯和順序產生。

多影像編輯

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro",
    "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/person.png"},
      {"image": "https://example.com/background.png"},
      {"text": "将图 1 中的人物放入图 2 的场景中"}
    ]}], "parameters": {"size": "2K", "n": 1, "prompt_extend": true}}
  }'

互動式區域編輯

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro", "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/room.png"},
      {"text": "将选中区域的花瓶替换成红玫瑰"}
    ]}], "parameters": {"size": "2K", "n": 1, "bbox_list": [[[420, 280, 760, 720]]]}}
  }'

序列影像組

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro", "input": {"messages": [{"role": "user", "content": [{"text": "生成四张角色一致的季节分镜"}]}]},
    "parameters": {"size": "2K", "enable_sequential": true, "n": 4, "watermark": false}
  }'

錯誤與失敗的任務

無效的模型參數傳回帶有請求ID的4xx；使用所選模型合約定義的回應欄位和錯誤訊息。

支援範圍

此頁面涵蓋 Modelflare 模型產生和編輯呼叫。搜尋或地圖豐富、語音管理和元素庫管理是此公共模型呼叫表面之外的資源 API，並且不是必需的請求欄位。

定價與計費

此模型使用按呼叫計費。請參閱 型號定價頁面 ，以了解當前客戶價格、參考標價和完整規格。

注意

此頁面記錄了 Modelflare 的公共介面；此處顯示的欄位和限制是目前合約。

變體

型號 ID	差異
wan2.7-image-pro	本頁記錄的模型。