模型

每个能调用的模型都有一个模型 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 就当作「稍后再试或换个模型」。

所有能调用的模型

价格是每个单位的最低档；更高的分辨率、更长的时长和额外选项会更贵。每个模型的页面列出了所有档位。