PixVerse V6 Image-to-Video

This page is generated from the upstream official OpenAPI documentation. Endpoints, parameters and examples match the official docs; brand and API domain are replaced with ModelFold.

Endpoint

POST /jobs/createTask

Full URL: https://ai.modelfold.online/v1/jobs/createTask

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Query Task Status

After submitting a task, you can check its progress and retrieve the result through the unified query endpoint:

Get Task Details — Learn how to check task status and retrieve the generated result

TIP

In production, we recommend using the callBackUrl parameter to receive an automatic notification when generation is complete instead of polling the status endpoint.

TIP

Enabling audio costs more. With template_id, billing follows the template duration. For current prices, see ai.modelfold.online/pricing.

Market Overview — Browse all available models
Common API — View account credits and usage

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
`model`	`string`	Yes	The name of the model used for the generation task. Required field. Default：`"pixverse-v6/image-to-video"`。 Allowed values：`pixverse-v6/image-to-video`。示例：`pixverse-v6/image-to-video`。
`callBackUrl`	`string`	No	The callback URL to receive the completion notification of the generation task. Optional configuration, recommended for production environments. - After the task generation is completed, the system will push the task status and results to this URL via POST - The callback content includes the URL of the generated content and task-related information - Your callback interface must support receiving POST requests and JSON-formatted request bodies - You can also actively poll the task status by calling the task details interface 示例：`https://your-domain.com/api/callback`。
`input`	`object`	Yes	Input parameters for the image-to-video task
`input.prompt`	`string`	Yes	Generate prompt, cannot be empty, length is limited to 3-5000 characters. 示例：`Cinematic sunrise illuminating a mist-shrouded mountain lake, camera slowly skimming over the water, a flock of birds flying across the sky`。
`input.image_urls`	`array<string>`	Yes	Without template_id, provide 1 image (used as the first frame). With template_id, provide the number of images given by the template's effect_type (1 or 2). Single image size not exceeding 20 MB. Supports HTTP, HTTPS, and OSS addresses. Supported image formats include JPG, JPEG, PNG, and WebP.
`input.quality`	`string`	Yes	Required. Output video resolution. Supports 360p, 540p, 720p, and 1080p. Allowed values：`360p` / `540p` / `720p` / `1080p`。示例：`720p`。
`input.duration`	`integer`	Yes	Generated video duration in seconds, ranging from 1 to 15. Required when template_id is not passed; if template_id is passed, the video duration is fixed by the selected template, please do not pass this parameter at the same time. 示例：`5`。
`input.generate_audio_switch`	`boolean`	No	Whether to generate audio synchronized with the video content. Default：`false`。示例：`false`。
`input.generate_multi_clip_switch`	`boolean`	No	Whether to generate a multi-clip video. Default：`false`。示例：`false`。
`input.seed`	`integer`	No	Random seed, value range is 0-2147483647. Using the same parameters and seed helps improve result reproducibility. 示例：`123456789`。
`input.template_id`	`string`	No	Used to select a PixVerse video effect template. Please pass in the corresponding template_id. Once a template_id is provided, the video duration is fixed by the selected template, so duration cannot be set at the same time. effect_type indicates the number of images required by the selected template. Please upload the specified number of images accordingly. To preview the template effect, open https://static.aiquickdraw.com/tools/example/<template_id>.mp4 in a browser and replace <template_id> with the actual template ID. For example:https://static.aiquickdraw.com/tools/example/412736208886848.mp4. Available template list: 412736208886848 - Dive into the deep blue of love - Let every kiss turn into a dream. - effect_type: 2 411563216524736 - Skyline Track Flag - Unwavering. Next is the city-level entrance effect. - effect_type: 1 411316927927040 - Vibe Copines - Capture this vibe with tungtung. - effect_type: 1 411174903569216 - Crowd Focus - First person: The camera caught you - upload a selfie or group photo to become the focus of the audience - effect_type: 1 410999246341952 - Poke my little cutie - Pinch this little guy and watch it get cutely angry. - effect_type: 1 408891141511104 - Today is my birthday - Yes, I know you don't know me, but today is my birthday - effect_type: 1 410317363057408 - Mini Football Hero - Turn any photo into a mini chibi football hero and compete with giant players in a cinematic hyper-realistic stadium. - effect_type: 1 410285445698304 - Magma Rise - Rise from the ashes. Fight fire with fire. - effect_type: 1 410133101388544 - Cyber Armor: Reborn in the Rain 🌧️⚡ - Shatter the storm. Awaken the body of steel within. - effect_type: 1 409899296377728 - Product Landmark - Upload your product and turn it into a building! - effect_type: 1 408897485909952 - Mini Football Pitch - Upload your product and create a mini football pitch inside it! - effect_type: 1 408869061406656 - A kick through the world - Upload your product and let it shine on the night of the grand annual global competition! - effect_type: 1 408661207662528 - Small Town Footballer - Upload your product and enjoy the moment of victory! - effect_type: 1 409767750265728 - Crowned God in One Battle - You unexpectedly became the MVP of the game. - effect_type: 1 409766559675264 - Thriller Dance Steps - Upload a photo and watch it turn into an iconic viral dance trend! - effect_type: 1 409589071559552 - Dai Dai Dance - Vibe cheering dance template. A front-facing photo to easily join the dance floor clip. - effect_type: 1 407804339389760 - Fluffy Chef - Upload your product and cook in the fluffy kitchen - effect_type: 1 407658863287616 - Summer Postcard - Upload your product and join the summer special! - effect_type: 1 407474361215744 - Inhaled into Product Universe - Upload your product and enter the product universe! - effect_type: 1 407473438360320 - Fluffy Factory - Upload your product to make it in the fluffy factory - effect_type: 1 407467702283008 - Surfing Summer - Upload your product photo and start surfing! - effect_type: 1 385844572217469 - Love Launcher - A Valentine's Day moment in one shot. - effect_type: 1 406428904874432 - Kitty Shop - Upload your product image and let the cute cat transform into your street vendor! - effect_type: 1 406423682060736 - Courtyard Makeover Party - Upload your courtyard and give it a magical makeover! - effect_type: 1 406411724685760 - Ski Joy - Upload a photo of your pet, toy or product and let it embark on a fun skiing adventure. - effect_type: 1 406372274350528 - Nail Lab - Upload your nail photos and let our exclusive manicurists create exquisite nails for you. - effect_type: 1 406218913317312 - Rhythm Dash - Hit the beat, take off the crown. Welcome to the perfect score frenzy. - effect_type: 1 406218479198656 - Screen Killer King - The court needs a hero. So, you break through the screen. - effect_type: 1 406064763308480 - Dynamic Football Poster - From selfie to jersey photo (single and multiplayer) - effect_type: 1 406413607395776 - Football Live King! - The moment you score a wonderful goal, super sports car gifts pour down. - effect_type: 1 405662117814720 - Trophy Breakthrough - Upload your photo, transform into a champion football player, break through the screen and win the trophy! - effect_type: 1 406014934000064 - Post-match Sharp Comment - If the microphone is handed to you after the game, what would you say? - effect_type: 1 405658369331648 - Stadium Legend - Run, celebrate, create a legendary football moment. - effect_type: 1 405321470423488 - Step by Step - Step by step, shining with confidence - effect_type: 1 405175211454656 - Superstar Lobby - Welcome to your championship season. - effect_type: 1 404955806201792 - Post-match Sharp Comment 2 - If it's your turn for a post-match interview, what would you say about this game? - effect_type: 1 404820147974080 - Top of the World - Hold the trophy high and become the well-deserved hero of the football feast. - effect_type: 2 398980393937856 - The Last Hug - The last hug before the tsunami comes. - effect_type: 2 403916646846400 - My Future has Infinite Possibilities - Embrace your infinite potential and shine your future. - effect_type: 1 403739217192896 - Apex Dance - Flat rhythm, decadent chaotic dance steps - effect_type: 1 403560060358144 - Idol Ending Shot - One look up is a million direct shots. - effect_type: 1 403556618212098 - MotoGP Live - Live an unchoreographed moment. - effect_type: 1 398965022284579 - Knee Slide - Celebrate the victory with an iconic and energetic knee slide goal. - effect_type: 1 402201060373270 - Tunnel to Captain - Transform from an ordinary girl to a legendary football captain in a cinematic stadium journey. - effect_type: 1 403085292466285 - Golden Field Breaker - He is not on the list, but he still controls the scene. - effect_type: 1 402061828030966 - Trophy Celebration - Have you always wanted a huge trophy? Here, you can at least get it digitally. - effect_type: 1 402888569901524 - Jump into the Crowd 2 - Jump into the crowd - effect_type: 1 402155676592228 - World Champion Lift - You are the captain, lifting the trophy of victory. Mountains of people, golden ribbons, pure victory. - effect_type: 1 402047865383360 - Sideline Ball Boy - Experience the game from a unique perspective on the sidelines. Feel the excitement of the game as a young talent ready to participate. - effect_type: 1 402046136040202 - Epic Save - Become a legendary goalkeeper. Catch the ball in a stunning flying save. - effect_type: 1 Allowed values：`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`。

Request Example

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"
}

Response

200 — Request successful.

Callback

videoTaskCompleted

Callback URL: {request.body#/callBackUrl} (the callBackUrl in the request body).

The system sends this callback when the pixverse-v6/image-to-video task succeeds or fails.

Callback body parameters

参数	类型	必填	说明
`code`	`integer`	是	Unified callback code: 200 for success, 501 for failure. Allowed values：`200` / `501`。示例：`200`。
`msg`	`string`	是	Unified callback message. Allowed values：`Playground task completed successfully.` / `Playground task failed.`。示例：`Playground task completed successfully.`。
`data`	`object`	是	—
`data.taskId`	`string`	是	The unique task identifier.
`data.model`	`string`	是	The model used for the task. Allowed values：`pixverse-v6/image-to-video`。示例：`pixverse-v6/image-to-video`。
`data.state`	`string`	是	Terminal task state. Allowed values：`success` / `fail`。示例：`success`。
`data.param`	`string`	是	JSON string containing the submitted task parameters.
`data.resultJson`	`string`	否	JSON string containing resultUrls, firstFrameUrl, lastFrameUrl, or resultObject when successful. Present only when state is success.
`data.failCode`	`string`	否	Failure code, a numeric string such as "400" or "500". Present only when state is fail.
`data.failMsg`	`string`	否	Failure reason. Present only when state is fail.
`data.costTime`	`integer`	否	Processing time in seconds. Present on both success and failure callbacks.
`data.completeTime`	`integer`	否	Task completion timestamp.
`data.createTime`	`integer`	否	Task creation timestamp.
`data.updateTime`	`integer`	否	Use completeTime as the completion time; updateTime may equal createTime.
`data.creditsConsumed`	`number`	否	Credits consumed by the task; 0 for failed tasks.

Task completed successfully

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
  }
}

Task failed

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 Image-to-Video ​

Endpoint ​

Query Task Status ​

Related Resources ​

Request Parameters ​

Body (application/json) ​

Request Example ​

Response ​

200 — Request successful. ​

Callback ​

videoTaskCompleted ​

PixVerse V6 Image-to-Video

Endpoint

Query Task Status

Related Resources

Request Parameters

Body (application/json)

Request Example

Response

200 — Request successful.

Callback

videoTaskCompleted