ModelFold Docs

English

简体中文

English

简体中文

Appearance

Bytedance V1 Pro 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.

Content generation using bytedance/v1-pro-image-to-video

Query Task Status ​

After submitting a task, use the unified query endpoint to check progress and retrieve results:

  • Get Task Details — Learn how to query task status and retrieve generation results

TIP

For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.

Request Parameters ​

Body (application/json) ​

ParameterTypeRequiredDescription
modelstringYesThe model name to use for generation. Required field.
- Must be bytedance/v1-pro-image-to-video for this endpoint Default："bytedance/v1-pro-image-to-video"。 Allowed values：bytedance/v1-pro-image-to-video。 示例：bytedance/v1-pro-image-to-video。
callBackUrlstringNoThe URL to receive generation task completion updates. Optional but recommended for production use.
- System will POST task status and results to this URL when generation completes
- Callback includes generated content URLs and task information
- Your callback endpoint should accept POST requests with JSON payload containing results
- Alternatively, use the Get Task Details endpoint to poll task status
- To ensure callback security, see Webhook Verification Guide for signature verification implementation 示例：https://your-domain.com/api/callback。
inputobjectNoInput parameters for the generation task
  input.promptstringYesThe text prompt used to generate the video (Max length: 10000 characters) 示例：A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds。
  input.image_urlstringYesThe URL of the image used to generate video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB) 示例：https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp。
  input.resolutionstringNoVideo resolution - 480p for faster generation, 720p for balance, 1080p for higher quality Default："720p"。 Allowed values：480p / 720p / 1080p。 示例：720p。
  input.durationstringNoDuration of the video in seconds Default："5"。 Allowed values：5 / 10。 示例：5。
  input.camera_fixedbooleanNoWhether to fix the camera position (Boolean value (true/false)) 示例：false。
  input.seednumberNoRandom seed to control video generation. Use -1 for random. (Min: -1, Max: 2147483647, Step: 1) (step: 1) Default：-1。 示例：-1。
  input.enable_safety_checkerbooleanNoThe safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (Boolean value (true/false)) 示例：true。
  input.nsfw_checkerbooleanNoDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.

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": "bytedance/v1-pro-image-to-video",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp",
    "resolution": "720p",
    "duration": "5",
    "camera_fixed": false,
    "seed": -1,
    "enable_safety_checker": true,
    "nsfw_checker": true
  }
}'
json
{
  "model": "bytedance/v1-pro-image-to-video",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp",
    "resolution": "720p",
    "duration": "5",
    "camera_fixed": false,
    "seed": -1,
    "enable_safety_checker": true,
    "nsfw_checker": true
  }
}

Response ​

200 — Request successful ​

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_bytedance_1765186750343"
  }
}

Callback ​

videoTaskCompleted ​

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

The system sends this callback when the bytedance/v1-pro-image-to-video task succeeds or fails.

Callback body parameters

参数类型必填说明
codeinteger是Unified callback code: 200 for success, 501 for failure. Allowed values：200 / 501。 示例：200。
msgstring是Unified callback message. Allowed values：Playground task completed successfully. / Playground task failed.。 示例：Playground task completed successfully.。
dataobject是—
  data.taskIdstring是The unique task identifier.
  data.modelstring是The model used for the task. Allowed values：bytedance/v1-pro-image-to-video。 示例：bytedance/v1-pro-image-to-video。
  data.statestring是Terminal task state. Allowed values：success / fail。 示例：success。
  data.paramstring是JSON string containing the submitted task parameters.
  data.resultJsonstring否JSON string containing resultUrls, firstFrameUrl, lastFrameUrl, or resultObject when successful. Present only when state is success.
  data.failCodestring否Failure code, a numeric string such as "400" or "500". Present only when state is fail.
  data.failMsgstring否Failure reason. Present only when state is fail.
  data.costTimeinteger否Processing time in seconds. Present on both success and failure callbacks.
  data.completeTimeinteger否Task completion timestamp.
  data.createTimeinteger否Task creation timestamp.
  data.updateTimeinteger否Use completeTime as the completion time; updateTime may equal createTime.
  data.creditsConsumednumber否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": "bytedance/v1-pro-image-to-video",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen i...\\\",\\\"image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"resolution\\\":\\\"720p\\\",\\\"duration\\\":\\\"5\\\",\\\"camera_fixed\\\":false,\\\"seed\\\":-1,\\\"enable_safety_checker\\\":true,\\\"nsfw_checker\\\":true}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"bytedance/v1-pro-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": "bytedance/v1-pro-image-to-video",
    "state": "fail",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen i...\\\",\\\"image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"resolution\\\":\\\"720p\\\",\\\"duration\\\":\\\"5\\\",\\\"camera_fixed\\\":false,\\\"seed\\\":-1,\\\"enable_safety_checker\\\":true,\\\"nsfw_checker\\\":true}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"bytedance/v1-pro-image-to-video\"}",
    "failCode": "400",
    "failMsg": "<error detail>",
    "costTime": 12,
    "creditsConsumed": 0
  }
}

ModelFold — one API for all the best AI models.

© 2026 ModelFold