PixVerse V6 图生视频

本页由 ModelFold 文档站根据上游官方 OpenAPI 文档同步生成。接口路径、参数、示例与官方保持一致；品牌与 API 域名已替换为 ModelFold。

接口

POST /jobs/createTask

完整 URL: https://ai.modelfold.online/v1/jobs/createTask

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

查询任务状态

    提交任务后，可通过统一的查询接口查看任务进度并获取结果：

    - [Get Task Details](/market/common/get-task-detail) — 了解如何查询任务状态并获取生成结果

TIP

生产环境中，建议使用 callBackUrl 参数接收生成完成的自动通知，而非轮询状态接口。

TIP

开启音频价格更高。使用 template_id 时按模板时长计费。当前价格见 ai.modelfold.online/pricing。

    ## 相关资源

    
      - [Market Overview](/market/quickstart) — 浏览所有可用模型
      - [Common API](/common-api/get-account-credits) — 查看账户积分与使用情况

请求参数

请求体 (application/json)

参数	类型	必填	说明
`model`	`string`	是	生成任务的模型名称。必填字段。默认值：`"pixverse-v6/image-to-video"`。可选值：`pixverse-v6/image-to-video`。示例：`pixverse-v6/image-to-video`。
`callBackUrl`	`string`	否	用于在生成任务完成时接收通知的回调 URL。选填，但建议在生产环境中使用。 - 任务生成后，系统将通过 POST 请求将任务状态和结果推送到此 URL - 回调内容包括生成内容的 URL 和任务相关信息 - 您的回调 API 必须支持 POST 请求和 JSON 格式的请求体 - 或者，您可以通过调用任务详情 API 主动轮询任务状态示例：`https://example.com/callback`。
`input`	`object`	是	生成任务的输入参数
`input.prompt`	`string`	是	生成提示词，不能为空，长度限制为 3–5000 个字符示例：`A cat walking on the beach at sunset`。
`input.image_urls`	`array<string>`	是	不使用模板时传 1 张图（作为首帧）；使用模板时按模板的 effect_type 传 1 或 2 张。单张图片大小不超过 20 MB。支持 HTTP、HTTPS 和 OSS 地址，图片格式支持 JPG、JPEG、PNG 和 WebP。
`input.quality`	`string`	是	必填。清晰度。可选值：`360p` / `540p` / `720p` / `1080p`。示例：`1080p`。
`input.duration`	`integer`	是	生成视频时长，单位为秒，范围为 1–15。未传入 template_id 时必填；传入 template_id 后，视频时长由所选模板固定，请勿同时传入该参数。示例：`5`。
`input.generate_audio_switch`	`boolean`	否	是否生成音频。默认值：`false`。示例：`false`。
`input.generate_multi_clip_switch`	`boolean`	否	是否启用 PixVerse V6 multi-clip。默认值：`false`。示例：`false`。
`input.seed`	`integer`	否	随机种子，可选。范围 0-2147483647。示例：`42`。
`input.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`。

请求示例

bash

curl -X POST "https://ai.modelfold.online/v1/jobs/createTask" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "pixverse-v6/image-to-video",
  "input": {
    "prompt": "Animate the subject with gentle wind and cinematic lighting",
    "image_urls": [
      "https://example.com/input-image.png"
    ],
    "duration": 5,
    "quality": "720p",
    "generate_audio_switch": false,
    "generate_multi_clip_switch": false,
    "seed": 123456
  },
  "callBackUrl": "https://example.com/ModelFold/callback"
}'

json

{
  "model": "pixverse-v6/image-to-video",
  "input": {
    "prompt": "Animate the subject with gentle wind and cinematic lighting",
    "image_urls": [
      "https://example.com/input-image.png"
    ],
    "duration": 5,
    "quality": "720p",
    "generate_audio_switch": false,
    "generate_multi_clip_switch": false,
    "seed": 123456
  },
  "callBackUrl": "https://example.com/ModelFold/callback"
}

响应

200 — 请求成功

参数	类型	必填	说明
`code`	`integer`	是	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。可选值：`200` / `401` / `402` / `404` / `422` / `429` / `433` / `455` / `500` / `501` / `505`。示例：`200`。
`msg`	`string`	是	响应消息，失败时的错误描述
`data`	`object`	是	—
`data.taskId`	`string`	是	可以使用任务 ID 与“获取任务详细信息”端点一起查询任务状态。

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_bytedance_1765186743319"
  }
}

回调

videoTaskCompleted

回调地址：{request.body#/callBackUrl}（即请求体里的 callBackUrl）。

当 pixverse-v6/image-to-video 任务成功或失败时，系统会发送此回调。

回调体参数

参数	类型	必填	说明
`code`	`integer`	是	统一回调状态码：成功为 200，失败为 501。可选值：`200` / `501`。示例：`200`。
`msg`	`string`	是	统一回调消息。可选值：`Playground task completed successfully.` / `Playground task failed.`。示例：`Playground task completed successfully.`。
`data`	`object`	是	—
`data.taskId`	`string`	是	任务唯一标识符。
`data.model`	`string`	是	任务使用的模型。可选值：`pixverse-v6/image-to-video`。示例：`pixverse-v6/image-to-video`。
`data.state`	`string`	是	任务最终状态。可选值：`success` / `fail`。示例：`success`。
`data.param`	`string`	是	包含已提交任务参数的 JSON 字符串。
`data.resultJson`	`string`	否	任务成功时，包含 resultUrls、firstFrameUrl、lastFrameUrl 或 resultObject 的 JSON 字符串。仅在 state 为 success 时出现。
`data.failCode`	`string`	否	失败码，数字字符串，如 "400"、"500"。仅在 state 为 fail 时出现。
`data.failMsg`	`string`	否	失败原因，仅在 state 为 fail 时出现。
`data.costTime`	`integer`	否	处理耗时（秒），成功和失败回调都会返回。
`data.completeTime`	`integer`	否	任务完成时间戳。
`data.createTime`	`integer`	否	任务创建时间戳。
`data.updateTime`	`integer`	否	完成时间请以 completeTime 为准；updateTime 可能与 createTime 相同。
`data.creditsConsumed`	`number`	否	本任务消耗的积分；失败任务为 0。

任务成功完成

json

{
  "code": 200,
  "msg": "Playground task completed successfully.",
  "data": {
    "taskId": "task_example_video_webhook_001",
    "model": "pixverse-v6/image-to-video",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Animate the subject with gentle wind and cinematic lighting\\\",\\\"image_urls\\\":[\\\"https://example.com/input-image.jpg\\\"],\\\"duration\\\":5,\\\"quality\\\":\\\"720p\\\",\\\"generate_audio_switch\\\":false,\\\"generate_multi_clip_switch\\\":false,\\\"seed\\\":123456}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"pixverse-v6/image-to-video\"}",
    "resultJson": "{\"resultUrls\":[\"https://example.com/generated-video.mp4\"]}",
    "costTime": 12,
    "completeTime": 1234567890,
    "createTime": 1234560000,
    "updateTime": 1234567890,
    "creditsConsumed": 1.23
  }
}

任务失败

json

{
  "code": 501,
  "msg": "Playground task failed.",
  "data": {
    "taskId": "task_example_video_webhook_001",
    "model": "pixverse-v6/image-to-video",
    "state": "fail",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Animate the subject with gentle wind and cinematic lighting\\\",\\\"image_urls\\\":[\\\"https://example.com/input-image.jpg\\\"],\\\"duration\\\":5,\\\"quality\\\":\\\"720p\\\",\\\"generate_audio_switch\\\":false,\\\"generate_multi_clip_switch\\\":false,\\\"seed\\\":123456}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"pixverse-v6/image-to-video\"}",
    "failCode": "400",
    "failMsg": "<error detail>",
    "costTime": 12,
    "creditsConsumed": 0
  }
}

PixVerse V6 图生视频 ​

接口 ​

查询任务状态 ​

请求参数 ​

请求体 (application/json) ​

请求示例 ​

响应 ​

200 — 请求成功 ​

回调 ​

videoTaskCompleted ​

PixVerse V6 图生视频

接口

查询任务状态

请求参数

请求体 (application/json)

请求示例

响应

200 — 请求成功

回调

videoTaskCompleted