PixVerse V6 图生视频

接口

POST /videos/generations

完整 URL: https://modelfold.ai/v1/videos/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

模型参数直接放在 JSON 请求体中，不要套 input。请求等待生成完成后返回 data[].url；支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。

生成任务的输入参数

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	生成任务的模型名称。必填字段。 默认值："pixverse-v6/image-to-video"。 可选值：pixverse-v6/image-to-video。 示例：pixverse-v6/image-to-video。
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。生成提示词，不能为空，长度限制为 3–5000 个字符 minLength: 3. maxLength: 2000. 示例：A cat walking on the beach at sunset。
image_urls	array<string>	是	不使用模板时传 1 张图（作为首帧）；使用模板时按模板的 effect_type 传 1 或 2 张。单张图片大小不超过 20 MB。支持 HTTP、HTTPS 和 OSS 地址，图片格式支持 JPG、JPEG、PNG 和 WebP。 maxItems: 2.
quality	string	是	必填。清晰度。 可选值：360p / 540p / 720p / 1080p。 示例：1080p。
duration	integer	是	生成视频时长，单位为秒，范围为 1–15。未传入 template_id 时必填；传入 template_id 后，视频时长由所选模板固定，请勿同时传入该参数。 minimum: 1. maximum: 15. 示例：5。
generate_audio_switch	boolean	否	是否生成音频。 默认值：false。 示例：false。
generate_multi_clip_switch	boolean	否	是否启用 PixVerse V6 multi-clip。 默认值：false。 示例：false。
seed	integer	否	随机种子，可选。范围 0-2147483647。 minimum: 0. maximum: 2147483647. 示例：42。
template_id	string	否	用于选择 PixVerse 视频特效模板，请传入对应的 template_id。传入 template_id 后，视频时长将由所选模板固定，不能同时设置 duration。effect_type 表示该模板要求传入的图片数量，请按对应数量上传图片。如需预览模板效果，请在浏览器中打开 https://static.aiquickdraw.com/tools/example/<template_id>.mp4，并将 <template_id> 替换为实际的模板 ID。例如：https://static.aiquickdraw.com/tools/example/412736208886848.mp4。 可用模板列表： 412736208886848 - 跃入爱的深蓝 - 让每一个吻都化作一场梦。 - effect_type: 2 411563216524736 - 天际轨道旗帜 - 坚定不移。接下来是城市级入场特效。 - effect_type: 1 411316927927040 - Vibe Copines：氛围闺蜜 - 与 tungtung 一起拿捏这份氛围。 - effect_type: 1 411174903569216 - 人群焦点 - 第一视角：镜头捕捉到你了——上传自拍或合照，成为全场焦点 - effect_type: 1 410999246341952 - 戳戳我的小可爱 - 捏捏这个小家伙，看它变得萌萌地生气。 - effect_type: 1 408891141511104 - 今天是我的生日 - 是的，我知道你不认识我，但今天是我的生日 - effect_type: 1 410317363057408 - 迷你足球英雄 - 将任何照片变成迷你Q版足球英雄，在电影般的超写实体育场中与巨型球员同场竞技。 - effect_type: 1 410285445698304 - 熔岩崛起 - 从灰烬中崛起。以火攻火。 - effect_type: 1 410133101388544 - 赛博装甲：雨中重生 🌧️⚡ - 粉碎风暴。唤醒体内的钢铁之躯。 - effect_type: 1 409899296377728 - 产品地标 - 上传你的产品，把它变成一座建筑！ - effect_type: 1 408897485909952 - 迷你足球场 - 上传您的产品，在产品中创建迷你足球场！ - effect_type: 1 408869061406656 - 一脚穿越世界 - 上传您的产品，让它在一年一度的全球盛大比赛之夜闪耀登场！ - effect_type: 1 408661207662528 - 小镇足球家 - 上传您的产品，享受胜利的时刻！ - effect_type: 1 409767750265728 - 一战封神 - 你意外地成为了比赛的MVP。 - effect_type: 1 409766559675264 - 惊悚舞步 - 上传照片，观看它变成病毒式传播的标志性舞蹈潮流！ - effect_type: 1 409589071559552 - 戴戴舞 - 氛围助威舞模板。一张正面照，轻松加入舞场片段。 - effect_type: 1 407804339389760 - 切绒小厨 - 上传你的产品，在毛茸茸厨房里烹饪吧 - effect_type: 1 407658863287616 - 夏日明信片 - 上传你的产品，加入夏日特辑！ - effect_type: 1 407474361215744 - 吸入产品宇宙 - 上传您的产品，进入产品宇宙！ - effect_type: 1 407473438360320 - 毛茸茸工厂 - 上传您的产品，在毛茸茸工厂中制作 - effect_type: 1 407467702283008 - 逐浪夏日 - 上传你的产品照片，开始冲浪！ - effect_type: 1 385844572217469 - 爱之发射器 - 一次拍摄中的情人节时刻。 - effect_type: 1 406428904874432 - 猫咪小铺 - 上传你的商品图，让可爱的猫咪变身你的街头小贩！ - effect_type: 1 406423682060736 - 庭院焕新趴 - 上传你的庭院，给它一个魔法般的改造吧！ - effect_type: 1 406411724685760 - 滑雪乐 - 上传一张你的宠物、玩具或产品的照片，让它开启一段有趣的滑雪冒险。 - effect_type: 1 406372274350528 - 美甲实验室 - 上传您的美甲照片，让我们的专属美甲师为您打造精致美甲。 - effect_type: 1 406218913317312 - 节奏冲刺 - 卡准律动，摘下王冠。欢迎来到满分狂潮。 - effect_type: 1 406218479198656 - 荧幕绝杀王 - 球场需要英雄。于是，你穿透屏幕破壁而入。 - effect_type: 1 406064763308480 - 动态足球海报 - 一张自拍到球衣照（单人与多人） - effect_type: 1 406413607395776 - 足球直播王！ - 在您打出精彩进球的瞬间，超级跑车礼物倾泻而下。 - effect_type: 1 405662117814720 - 奖杯突破 - 上传你的照片，化身冠军足球选手，突破屏幕，赢得奖杯！ - effect_type: 1 406014934000064 - 赛后锐评 - 如果赛后将麦克风交给你，你会说什么？ - effect_type: 1 405658369331648 - 球场传奇 - 奔跑、庆祝，创造一个传奇的足球时刻。 - effect_type: 1 405321470423488 - 一步一步来 - 循序渐进，自信闪耀 - effect_type: 1 405175211454656 - 超级明星大厅 - 欢迎来到你的冠军赛季。 - effect_type: 1 404955806201792 - 赛后锐评 - 如果赛后采访轮到你，你会怎么评价这场比赛？ - effect_type: 1 404820147974080 - 世界之巅 - 高举奖杯，成为足球盛宴当之无愧的英雄。 - effect_type: 2 398980393937856 - 最后的拥抱 - 海啸来临前的最后一个拥抱。 - effect_type: 2 403916646846400 - 我的未来无限可能 - 拥抱你无限的潜能，闪耀前程。 - effect_type: 1 403739217192896 - Apex Dance - 平躺节奏，颓废风混乱舞步 - effect_type: 1 403560060358144 - 爱豆ending镜头 - 一抬眼就是百万直拍的程度。 - effect_type: 1 403556618212098 - 摩托GP直播 - 直播一个无法编排的时刻。 - effect_type: 1 398965022284579 - 膝滑 - 用标志性和充满活力的膝滑进球庆祝胜利。 - effect_type: 1 402201060373270 - 通往队长的隧道 - 在电影般的体育场旅程中，从一个普通女孩转变为传奇足球队长。 - effect_type: 1 403085292466285 - 金色场地破坏者 - 他不在名单上，但他依然掌控了场面。 - effect_type: 1 402061828030966 - 奖杯庆祝 - 你一直想要一个巨大的奖杯吗？在这里，你至少可以以数字形式获得它。 - effect_type: 1 402888569901524 - 跳入人群 2 - 跳入人群 - effect_type: 1 402155676592228 - 世界冠军举起 - 你是队长，举起胜利的奖杯。人山人海，金色的彩带，纯粹的胜利。 - effect_type: 1 402047865383360 - 场边球童 - 从场边独特的视角体验比赛。作为一名准备参与的年轻人才，感受比赛的激动人心。 - effect_type: 1 402046136040202 - 史诗级的扑救 - 成为传奇门将。在惊人的飞身扑救中接住球。 - effect_type: 1 可选值：412736208886848 / 411563216524736 / 411316927927040 / 411174903569216 / 410999246341952 / 408891141511104 / 410317363057408 / 410285445698304 / 410133101388544 / 409899296377728 / 408897485909952 / 408869061406656 / 408661207662528 / 409767750265728 / 409766559675264 / 409589071559552 / 407804339389760 / 407658863287616 / 407474361215744 / 407473438360320 / 407467702283008 / 385844572217469 / 406428904874432 / 406423682060736 / 406411724685760 / 406372274350528 / 406218913317312 / 406218479198656 / 406064763308480 / 406413607395776 / 405662117814720 / 406014934000064 / 405658369331648 / 405321470423488 / 405175211454656 / 404955806201792 / 404820147974080 / 398980393937856 / 403916646846400 / 403739217192896 / 403560060358144 / 403556618212098 / 398965022284579 / 402201060373270 / 403085292466285 / 402061828030966 / 402888569901524 / 402155676592228 / 402047865383360 / 402046136040202。 示例：412736208886848。

请求示例

curl -X POST "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": "A cat walking on the beach at sunset",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "quality": "1080p",
  "duration": 5,
  "generate_audio_switch": false,
  "generate_multi_clip_switch": false
}'

{
  "model": "pixverse-v6/image-to-video",
  "prompt": "A cat walking on the beach at sunset",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "quality": "1080p",
  "duration": 5,
  "generate_audio_switch": false,
  "generate_multi_clip_switch": false
}

响应

200 — 生成完成。usage 返回实际计费明细；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}