Wan 2.5 - 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.

Video generation by wan/2-5-image-to-video

Create Task

Use this endpoint to create a new image-to-video generation task.

Get Task Details — After submission, use the unified query endpoint to check task progress and retrieve results

TIP

For production use, we recommend providing the callBackUrl parameter so your service can receive completion notifications instead of polling for task status.

Model Marketplace — Explore all available models and capabilities
Common API — Check account credits and usage

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
`model`	`string`	Yes	The model name used for generation. This field is required. - This endpoint must use the `wan/2-5-image-to-video` model Default：`"wan/2-5-image-to-video"`。 Allowed values：`wan/2-5-image-to-video`。示例：`wan/2-5-image-to-video`。
`callBackUrl`	`string`	No	Callback URL for task completion notifications. Optional parameter. If provided, the system will send a POST request to this URL when the task completes, whether it succeeds or fails. If omitted, no callback notification will be sent. 示例：`https://your-domain.com/api/callback`。
`input`	`object`	Yes	Input parameters for the image-to-video task.
`input.prompt`	`string`	Yes	The text prompt describing the desired video motion. Maximum length: 800 characters. 示例：`The same woman from the reference image looks directly into the camera, takes a breath, then smiles brightly and speaks with enthusiasm: "Have you heard? Alibaba Wan 2.5 API is now available on ai.modelfold.online!" Ambient audio: quiet indoor atmosphere, soft natural room tone. Camera: medium close-up, steady framing, natural daylight mood, accurate lip-sync with dialogue.`。
`input.image_url`	`string`	Yes	URL of the image to use as the first frame. Must be publicly accessible. - Please provide the URL of the uploaded file, not raw file content - Accepted types: `image/jpeg`, `image/png`, `image/webp` - Max size: 10.0MB 示例：`https://file.aiquickdraw.com/custom-page/akr/section-images/1758796480945qb63zxq8.webp`。
`input.duration`	`string`	Yes	The duration of the generated video in seconds. - `5`: 5 seconds - `10`: 10 seconds Allowed values：`5` / `10`。示例：`5`。
`input.resolution`	`string`	Yes	Required. 720p or 1080p. Allowed values：`720p` / `1080p`。示例：`1080p`。
`input.negative_prompt`	`string`	No	Negative prompt used to describe content to avoid. Maximum length: 500 characters.
`input.enable_prompt_expansion`	`boolean`	No	Whether to enable prompt rewriting using LLM. - Boolean value: `true` / `false` 示例：`true`。
`input.seed`	`integer`	No	Random seed for reproducibility. If omitted, a random seed is chosen.
`input.nsfw_checker`	`boolean`	No	Defaults 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": "wan/2-5-image-to-video",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "The same woman from the reference image looks directly into the camera, takes a breath, then smiles brightly and speaks with enthusiasm: \"Have you heard? Alibaba Wan 2.5 API is now available on ai.modelfold.online!\" Ambient audio: quiet indoor atmosphere, soft natural room tone. Camera: medium close-up, steady framing, natural daylight mood, accurate lip-sync with dialogue.",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1758796480945qb63zxq8.webp",
    "duration": "5",
    "resolution": "1080p",
    "negative_prompt": "blurry, flicker, camera shake, distorted face, low quality",
    "enable_prompt_expansion": true,
    "seed": 123456,
    "nsfw_checker": false
  }
}'

json

{
  "model": "wan/2-5-image-to-video",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "The same woman from the reference image looks directly into the camera, takes a breath, then smiles brightly and speaks with enthusiasm: \"Have you heard? Alibaba Wan 2.5 API is now available on ai.modelfold.online!\" Ambient audio: quiet indoor atmosphere, soft natural room tone. Camera: medium close-up, steady framing, natural daylight mood, accurate lip-sync with dialogue.",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1758796480945qb63zxq8.webp",
    "duration": "5",
    "resolution": "1080p",
    "negative_prompt": "blurry, flicker, camera shake, distorted face, low quality",
    "enable_prompt_expansion": true,
    "seed": 123456,
    "nsfw_checker": false
  }
}

Response

200 — Request successful

参数	类型	必填	说明
`data`	`object`	否	—
`data.taskId`	`string`	否	Task ID, which can be used to query task status through the task detail endpoint. 示例：`task_wan_1765180586443`。

json

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

500 — Server error.

Callback

videoTaskCompleted

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

The system sends this callback when the wan/2-5-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：`wan/2-5-image-to-video`。示例：`wan/2-5-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": "wan/2-5-image-to-video",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"The same woman from the reference image looks directly into the camera, takes a breath, then smiles brightly and spea...\\\",\\\"image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"duration\\\":\\\"5\\\",\\\"resolution\\\":\\\"1080p\\\",\\\"negative_prompt\\\":\\\"blurry, flicker, camera shake, distorted face, low quality\\\",\\\"enable_prompt_expansion\\\":true,\\\"seed\\\":123456,\\\"nsfw_checker\\\":false}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"wan/2-5-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": "wan/2-5-image-to-video",
    "state": "fail",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"The same woman from the reference image looks directly into the camera, takes a breath, then smiles brightly and spea...\\\",\\\"image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"duration\\\":\\\"5\\\",\\\"resolution\\\":\\\"1080p\\\",\\\"negative_prompt\\\":\\\"blurry, flicker, camera shake, distorted face, low quality\\\",\\\"enable_prompt_expansion\\\":true,\\\"seed\\\":123456,\\\"nsfw_checker\\\":false}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"wan/2-5-image-to-video\"}",
    "failCode": "400",
    "failMsg": "<error detail>",
    "costTime": 12,
    "creditsConsumed": 0
  }
}

Wan 2.5 - Image to Video ​

Endpoint ​

Create Task ​

Related Resources ​

Request Parameters ​

Body (application/json) ​

Request Example ​

Response ​

200 — Request successful ​

500 — Server error. ​

Callback ​

videoTaskCompleted ​

Wan 2.5 - Image to Video

Endpoint

Create Task

Related Resources

Request Parameters

Body (application/json)

Request Example

Response

200 — Request successful

500 — Server error.

Callback

videoTaskCompleted