Wan 2.7 - Reference 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.

Create Task

Use this endpoint to create a new reference-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-7-r2v` model. Default：`"wan/2-7-r2v"`。 Allowed values：`wan/2-7-r2v`。示例：`wan/2-7-r2v`。
`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 reference-to-video task.
`input.prompt`	`string`	Yes	Text prompt. Required. Describes the desired elements and visual features in the generated video. Supports Chinese and English. Maximum length: 5000 characters. 示例：`Image 1 is eating, while video 1 and image 2 are singing beside it.`。
`input.negative_prompt`	`string`	No	Optional negative prompt describing what should not appear in the video. Supports Chinese and English. Maximum length: 500 characters. 示例：`low resolution, errors, worst quality, low quality, malformed, extra fingers, bad proportions`。
`input.reference_image`	`array<string>`	No	Array of reference image URLs. At least one of `reference_image` or `reference_video` must be provided. The total number of images and videos cannot exceed 5.
`input.reference_video`	`array<string>`	No	Array of reference video URLs. At least one of `reference_image` or `reference_video` must be provided. The total number of images and videos cannot exceed 5.
`input.first_frame`	`string`	No	First frame image URL. At most one image can be provided. If supplied, `aspect_ratio` is ignored and the output uses a ratio close to the first frame image. 示例：`https://example.com/demo/first-frame.png`。
`input.reference_voice`	`string`	No	Audio URL used to specify the voice timbre of the subject in the reference material. Rules: - If `reference_video` contains audio and `reference_voice` is not provided, the original video audio is used by default - If both `reference_video` and `reference_voice` are provided, `reference_voice` takes priority Audio limits: - Formats: `wav`, `mp3` - Duration: `1` to `10` seconds - File size: up to `30MB` 示例：`https://example.com/demo/reference-voice.mp3`。
`input.resolution`	`string`	No	Output video resolution tier. Available values: `720p`, `1080p`. Default value: `1080p`. Default：`"1080p"`。 Allowed values：`720p` / `1080p`。示例：`1080p`。
`input.aspect_ratio`	`string`	No	Output video aspect ratio. Effective logic: - If `first_frame` is not provided: the video is generated using the specified `aspect_ratio` - If `first_frame` is provided: `aspect_ratio` is ignored and the output uses a ratio close to the first frame image Default：`"16:9"`。 Allowed values：`16:9` / `9:16` / `1:1` / `4:3` / `3:4`。示例：`16:9`。
`input.duration`	`integer`	No	Output video duration in seconds. Valid range is an integer from `2` to `10`. Default value: `5`. Default：`5`。示例：`5`。
`input.prompt_extend`	`boolean`	No	Whether to enable prompt rewriting. When enabled, the model expands the input prompt. This usually works better for short prompts but increases processing time. Default：`true`。示例：`true`。
`input.watermark`	`boolean`	No	Whether to add a watermark. The watermark is placed in the lower-right corner of the video with the fixed text "AI generated". Default：`false`。示例：`false`。
`input.seed`	`integer`	No	Random seed. Range: `0-2147483647`. If omitted, the system generates one automatically. 示例：`0`。
`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-7-r2v",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Image 1 is eating, while video 1 and image 2 are singing beside it.",
    "negative_prompt": "low resolution, errors, worst quality, low quality, malformed, extra fingers, bad proportions",
    "reference_image": [
      "https://example.com/demo/ref-image-1.png",
      "https://example.com/demo/ref-image-2.png"
    ],
    "reference_video": [
      "https://example.com/demo/ref-video-1.mp4"
    ],
    "first_frame": "https://example.com/demo/first-frame.png",
    "reference_voice": "https://example.com/demo/reference-voice.mp3",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "prompt_extend": true,
    "watermark": false,
    "seed": 0
  }
}'

json

{
  "model": "wan/2-7-r2v",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Image 1 is eating, while video 1 and image 2 are singing beside it.",
    "negative_prompt": "low resolution, errors, worst quality, low quality, malformed, extra fingers, bad proportions",
    "reference_image": [
      "https://example.com/demo/ref-image-1.png",
      "https://example.com/demo/ref-image-2.png"
    ],
    "reference_video": [
      "https://example.com/demo/ref-video-1.mp4"
    ],
    "first_frame": "https://example.com/demo/first-frame.png",
    "reference_voice": "https://example.com/demo/reference-voice.mp3",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "prompt_extend": true,
    "watermark": false,
    "seed": 0
  }
}

Response

200 — Request successful

json

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

Callback

videoTaskCompleted

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

The system sends this callback when the wan/2-7-r2v 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-7-r2v`。示例：`wan/2-7-r2v`。
`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-7-r2v",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Image 1 is eating, while video 1 and image 2 are singing beside it.\\\",\\\"negative_prompt\\\":\\\"low resolution, errors, worst quality, low quality, malformed, extra fingers, bad proportions\\\",\\\"reference_image\\\":[\\\"https://example.com/input-image.jpg\\\"],\\\"reference_video\\\":[\\\"https://example.com/input-video.mp4\\\"],\\\"first_frame\\\":\\\"https://example.com/input-image.jpg\\\",\\\"reference_voice\\\":\\\"https://example.com/input-audio.mp3\\\",\\\"resolution\\\":\\\"1080p\\\",\\\"aspect_ratio\\\":\\\"16:9\\\",\\\"duration\\\":5,\\\"prompt_extend\\\":true,\\\"watermark\\\":false,\\\"seed\\\":0}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"wan/2-7-r2v\"}",
    "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-7-r2v",
    "state": "fail",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Image 1 is eating, while video 1 and image 2 are singing beside it.\\\",\\\"negative_prompt\\\":\\\"low resolution, errors, worst quality, low quality, malformed, extra fingers, bad proportions\\\",\\\"reference_image\\\":[\\\"https://example.com/input-image.jpg\\\"],\\\"reference_video\\\":[\\\"https://example.com/input-video.mp4\\\"],\\\"first_frame\\\":\\\"https://example.com/input-image.jpg\\\",\\\"reference_voice\\\":\\\"https://example.com/input-audio.mp3\\\",\\\"resolution\\\":\\\"1080p\\\",\\\"aspect_ratio\\\":\\\"16:9\\\",\\\"duration\\\":5,\\\"prompt_extend\\\":true,\\\"watermark\\\":false,\\\"seed\\\":0}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"wan/2-7-r2v\"}",
    "failCode": "400",
    "failMsg": "<error detail>",
    "costTime": 12,
    "creditsConsumed": 0
  }
}

Wan 2.7 - Reference to Video ​

Endpoint ​

Create Task ​

Related Resources ​

Request Parameters ​

Body (application/json) ​

Request Example ​

Response ​

200 — Request successful ​

Callback ​

videoTaskCompleted ​

Wan 2.7 - Reference to Video

Endpoint

Create Task

Related Resources

Request Parameters

Body (application/json)

Request Example

Response

200 — Request successful

Callback

videoTaskCompleted