PixVerse 768 个官方特效模板:Playground 预览,再用 API 批量出视频

0 阅读4分钟

2026 年 11 月 19 日,ModelFold 的 PixVerse V6 图生视频已经接上 768 个官方特效模板。这个数字来自 Playground 正在用的模板目录,不是估的。目录每 6 小时同步一次,以后可能还会增加。

网页上点「预览全部模板」,能把全部预览视频看完,选一个、按它要求的张数传图,就能出视频。同一套 template_id 也能走 API,适合一张图套多个特效。

积分价格以模型页和 Playground 当时显示的预扣为准,本文不写死。Playground 会显示这次实际预扣。

今天目录里有什么

和网页同一份列表:

curl -s https://modelfold.ai/api/playground/pixverse-templates | python3 -c "import sys,json; d=json.load(sys.stdin); print(len(d['templates']))"

11 月 19 日返回 768。同一份数据里:

  • 689 个要 1 张图,71 个要 2 张,5 个要 3 张,3 个要 5 张
  • 414 个是普通特效,354 个是 workflow 模板
  • 时长集中在 5、8、10、12、15 秒,由模板决定,不能自己传 duration
  • 我抽查的条目清晰度多是 720p

每条有 id、中英文名、所需张数、秒数、支持的清晰度,以及预览地址,都在 modelfold.ai 域名下。

下面 5 个都是 1 张图的模板,预览视频也在我们自己的域名上(不是这次新生成的,没有为此扣积分):

  1. 小小厨师贴纸大混乱(Tiny Sticker Chef Chaos),416276364653376,10 秒
    预览:modelfold.ai/examples/pi…
  2. 迷你足球英雄(Mini Football Hero),410317363057408,8 秒
    预览:modelfold.ai/examples/pi…
  3. 我爱在图书馆派对!(I love partying in the library!),423532683280704,10 秒
    预览:modelfold.ai/examples/pi…
  4. 帅气舞步:历史(Handsome Dance: History),423375773916096,15 秒
    预览:modelfold.ai/examples/pi…
  5. Celebrating a birthday with a lion,419846533483840,9 秒
    预览:modelfold.ai/examples/pi…

网页怎么玩

打开 V6 图生视频页,在 Playground 点 预览全部模板。弹层里是当前数量、搜索框、封面和循环预览。鼠标移上去或点一下就能播。

然后:

  1. 点「使用模板」。
  2. 按卡片上的张数、顺序传图。1 张的不要传 2 张。
  3. 不要填时长。选了模板之后,时长、音频、多镜头会藏起来,由模板决定。
  4. 看页面上的预扣积分,再生成。

不套特效的话,清掉模板,按普通图生视频传首帧和提示词即可。

API Key 在「账户 → 密钥」。新 Key 默认允许之后再查看、复制;创建时也可以改成只显示一次。

对话模型(含 GPT 系列)可以走包月订阅,不扣积分。视频模板仍按积分。档位和价格以定价页为准。

用 API 出一条

模型页上的示例走任务接口。能力页也是这一套。

export MODELFOLD_API_KEY=mf-你的密钥

curl -sS https://modelfold.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: chef-001" \
  -d '{
    "model": "pixverse-v6/image-to-video",
    "input": {
      "template_id": "416276364653376",
      "image_urls": ["https://example.com/subject.jpg"],
      "quality": "720p",
      "prompt": "按所选 PixVerse 模板处理这张照片。"
    }
  }'

文档里写明的规则:

  • template_id 用预览里的数字编号。
  • 图片张数、顺序必须和模板一致。
  • 用模板时不要传 duration,服务端会丢掉这个字段。
  • 网关仍然要 prompt(V6 图生视频文档:3–2000 字)。
  • quality 只能填该模板列出的档,不要默认 1080p。
  • 积分看模型页 / Playground,本文不写数字。

查询任务(只读,不会再扣一次):

curl -sS "https://modelfold.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY"

建议 5–10 秒查一次,直到成功或失败。也可以在创建时带 callBackUrl。说明:modelfold.ai/docs/market…

如果已经封装了 OpenAI 风格的网关,同一模型也可以走:

curl -sS https://modelfold.ai/v1/videos/generations \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6/image-to-video",
    "prompt": "按所选 PixVerse 模板处理这张照片。",
    "template_id": "416276364653376",
    "image_urls": ["https://example.com/subject.jpg"],
    "quality": "720p"
  }'

约束相同:模板不要带 duration,张数要匹配,清晰度看卡片。

一张图套多个模板

先拉目录,筛 1 张图、非 workflow、支持 720p 的条目,再给每一条单独的 Idempotency-Key,避免重试重复扣费。

import json, os, urllib.request

KEY = os.environ["MODELFOLD_API_KEY"]
IMAGE = "https://example.com/subject.jpg"  # 换成你的图,地址要让服务端能拉到

def get(url):
    req = urllib.request.Request(url, headers={"Authorization": f"Bearer {KEY}"})
    with urllib.request.urlopen(req) as r:
        return json.load(r)

def post(url, body, idem):
    req = urllib.request.Request(
        url,
        data=json.dumps(body).encode(),
        headers={
            "Authorization": f"Bearer {KEY}",
            "Content-Type": "application/json",
            "Idempotency-Key": idem,
        },
        method="POST",
    )
    with urllib.request.urlopen(req) as r:
        return json.load(r)

catalogue = get("https://modelfold.ai/api/playground/pixverse-templates")["templates"]
picked = [
    t for t in catalogue
    if t.get("images") == 1 and not t.get("workflow")
    and "720p" in (t.get("qualities") or ["720p"])
][:5]

for t in picked:
    quality = "720p" if "720p" in (t.get("qualities") or ["720p"]) else t["qualities"][0]
    body = {
        "model": "pixverse-v6/image-to-video",
        "input": {
            "template_id": t["id"],
            "image_urls": [IMAGE],
            "quality": quality,
            "prompt": f"按模板「{t.get('name') or t.get('nameEn')}」处理这张照片。",
        },
    }
    print(t["id"], t.get("name") or t.get("nameEn"))
    # print(post("https://modelfold.ai/api/v1/jobs/createTask", body, f"pv-{t['id']}"))

最后一行注释掉了。这篇没有真实跑付费视频。你换上测试图、取消注释再发,然后轮询 recordInfo。

同步之后如果某个编号从目录里消失,再用会报不支持。不要把编号本地写死以后永不更新。

同一把 Key 还能调哪些 PixVerse

现在站上还能进 C1 的图生视频 / 参考生视频 / 转场、数字人、扩图、超分、口型同步、多段转场等页面。从能力页点进对应模型页看入参。那些接口不要套 template_id。

这篇没测的

  • 五个预览是目录里的官方预览,不是我新生成的。
  • 没有测成功率、排队时间和 workflow 模板的分镜差别。
  • 积分以你点生成时页面上的预扣为准。

只出一条,用 Playground。一张脸要套二十个特效,就从目录取编号,走 createTask。