模型

每個可呼叫的模型都有一個模型 ID，填在 createTask 的 model 欄位。本頁最下方的表格列出所有模型與起始價格；點選模型名稱會進入它的參考頁，那裡有完整的參數清單、各級價格，以及一段可直接複製的請求。

模型 ID 的組成

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• **出品方（maker）**是打造這個模型的公司或團隊。PopNow 自家的工具寫成 popnow。
• **型號（model）**保留版本號裡的點：寫 seedance-2.0，不寫 seedance-2-0。
• **任務（task）**說明這次呼叫做什麼：text-to-image、edit、image-to-video、reference-to-video、video-extend、text-to-speech、text-to-audio 等。圖片編輯一律是 edit。

一個模型系列通常有好幾個 ID，每種任務一個。依你要送出的內容挑選：.../text-to-video 只需要提示詞，.../image-to-video 需要一張起始圖片。

用程式讀取模型目錄

即時目錄才是準的：它包含此刻能否使用，以及適用於你帳戶的價格。

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

清單的篩選參數：modality（image、video、audio）、provider、task、search，再加上 includeSchema=1 與 includeExamples=1，就能一併取得輸入 schema 與驗證過的範例輸入。如果你的 HTTP 用戶端把路徑參數當成單一片段，請把斜線編碼成 %2F。

值得讀取的欄位

讀取價格

credits 就是 popnow.ai 網站上顯示的同一個價格，單位是點數（1 點 = $0.01）：

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit 說明價格怎麼計算（per_image 每張、per_second 每秒、per_request 每次、per_1k_characters 每千字元），perUnit 是起始價格，每條規則會在請求符合它的 when 時套用（* 代表決定級距的設定，這裡是 resolution）。任務的最終扣點會無條件進位到整數點。

想知道某一個請求的確切價格，就用與 createTask 完全相同的請求內容呼叫 jobs/quote。

輸入 schema

inputSchema 是標準 JSON Schema（draft 2020-12）。所有模型都遵守這幾點：

• 不認得的欄位會被拒絕。 把 aspect_ratio 拼錯會回傳 400，不會被默默忽略。
• 欄位名稱跨模型通用。 同一個概念永遠是同一個名稱：prompt、negative_prompt、image_url、image_urls、video_url、audio_url、duration_seconds、aspect_ratio、resolution、seed、generate_audio。
• 預設值會自動帶入。 只傳你想改的就好。
• 素材欄位接受公開的 HTTPS 連結、你上傳得到的 popnow:// 檔案，或已儲存的素材。請見上傳與下載。
• 顯示提示放在每個屬性的 x-ui 物件中（標籤、順序、滑桿間距）。它們不影響驗證；不認得的鍵直接忽略即可。

有 seed 的模型，若你沒傳，會隨機挑一個並寫回任務的 input，喜歡某次結果時就能照著重現。

快取

目錄回應只屬於你的帳戶，可快取 60 秒。合適的做法是：清單快取幾分鐘，某個模型的 version 變了就重新讀取，遇到 available: false 就當成「稍後再試或換個模型」。

所有可呼叫的模型

價格是每個單位的最低級距；更高的解析度、更長的片長與額外選項會更貴。每個模型的頁面都列出所有級距。