Wan 2.6 - Image to Video
Endpoint
POST /videos/generations
Full URL: https://modelfold.ai/v1/videos/generations
Authentication: every request must include the
Authorization: Bearer <API_KEY>header.
Send model parameters directly in the JSON body. Do not wrap them in input. This request waits for generation to finish and returns data[].url; supported media models also offer async jobs, polling and callbacks. Replace example media URLs with your own publicly accessible files. See API gateway for billing and errors.
Input parameters for the generation task
Request Parameters
Body (application/json)
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | The model name to use for generation. Required field. - Must be wan/2-6-image-to-video for this endpoint Default:"wan/2-6-image-to-video"。 Allowed values:wan/2-6-image-to-video。 Example:wan/2-6-image-to-video。 |
prompt | string | Yes | Prompt required by the ModelFold gateway; at most 2000 characters. Text prompts for video generation. Supports both Chinese and English, with a minimum of 2 characters and a maximum of 5,000 characters. (Max length: 5000 characters) maxLength: 2000. Example:Anthopmopric fox singing a Christmas song at the rubbish dump in the rain.。 |
image_urls | array<string> | Yes | Upload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB),All images must be at least 256x256px. maxItems: 1. |
duration | string | No | The duration of the generated video in seconds Default:"5"。 Allowed values:5 / 10 / 15。 Example:5。 |
resolution | string | No | Video resolution tier Default:"1080p"。 Allowed values:720p / 1080p。 Example:1080p。 |
multi_shots | boolean | No | The multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. Default:false。 Example:false。 |
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://modelfold.ai/v1/videos/generations" \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan/2-6-image-to-video",
"prompt": "Anthopmopric fox singing a Christmas song at the rubbish dump in the rain.",
"image_urls": [
"https://example.com/reference.png"
],
"duration": "5",
"resolution": "1080p"
}'json
{
"model": "wan/2-6-image-to-video",
"prompt": "Anthopmopric fox singing a Christmas song at the rubbish dump in the rain.",
"image_urls": [
"https://example.com/reference.png"
],
"duration": "5",
"resolution": "1080p"
}Response
200 — Generation completed. usage contains actual billing details; result URLs are illustrative.
json
{
"ok": true,
"created": 1792134000,
"data": [
{
"url": "https://modelfold.ai/uploads/outputs/result.mp4"
}
],
"usage": {}
}