POST
/
video
/
img2video_ultra
Generate HD video from image
curl --request POST \
  --url https://modelslab.com/api/v6/video/img2video_ultra \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "<string>",
  "model_id": "wan2.1",
  "prompt": "<string>",
  "init_image": "<string>",
  "negative_prompt": "<string>",
  "seed": 123,
  "resolution": 123,
  "num_frames": 81,
  "num_inference_steps": 25,
  "guidance_scale": 4,
  "fps": 15,
  "portrait": false,
  "sample_shift": 5,
  "base64": false,
  "temp": false,
  "webhook": "<string>",
  "track_id": "<string>"
}'
{
  "status": "success",
  "generationTime": 123,
  "id": 123,
  "output": [
    "<string>"
  ],
  "proxy_links": [
    "<string>"
  ],
  "future_links": [
    "<string>"
  ],
  "meta": {},
  "eta": 123,
  "message": "<string>",
  "tip": "<string>",
  "fetch_result": "<string>"
}

​
Image to Video Ultra

Generate high-definition videos from images.

​
Request

Make a POST request to below endpoint and pass the required parameters in the request body.
curl
--request POST 'https://modelslab.com/api/v6/video/img2video_ultra' \

​
Body

json
{
    "key":"",
    "init_image":"https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/livewire-tmp/Vil4dkFzgFw0xyU7YsF4YqzJQXuGmr-metaNTliM2VmYTNmODE2NjdiMzljYjYzOTdlOGU5Nzg1OTAud2VicA==-.webp",
    "prompt":"moving character",
    "model_id": "wan2.1",
    "negative_prompt":"low quality",
    "resolution":320,
    "num_frames": 92,
    "num_inference_steps":8,
    "guidance_scale":1.0,
    "webhook": null,
    "track_id":null
}

Body

application/json
​
key
string
required

Your API Key used for request authorization

​
model_id
enum<string>
default:wan2.1
required

The model ID to use for video generation. wan2.2 or wan2.1

Available options:
wan2.2,
wan2.1
​
prompt
string
required

Text prompt describing the video content

​
init_image
string<uri>
required

URL of the initial image

​
negative_prompt
string

Items you don't want in the video

​
seed
integer | null

Seed for reproducible results

​
resolution
integer

Resolution of the output

Required range: x <= 480
​
num_frames
integer
default:81

Number of frames

​
num_inference_steps
integer
default:25

Number of denoising steps

Required range: x <= 25
​
guidance_scale
number

Guidance scale

Required range: 0 <= x <= 8
​
fps
integer

Frames per second

Required range: x <= 16
​
portrait
boolean
default:false

Portrait mode gives output in 9:16 aspect ratio.

​
sample_shift
integer
default:5

Sampling shift

Required range: x <= 10
​
base64
boolean
default:false

Input image is base64 format

​
temp
boolean
default:false

Store in temporary storage

​
webhook
string<uri>

Webhook URL

​
track_id
string

Tracking ID

Response

HD image-to-video generation response

​
status
enum<string>

Status of the video generation

Available options:
success,
processing,
error
​
generationTime
number

Time taken to generate the video in seconds

​
id
integer

Unique identifier for the video generation

​
output
string<uri>[]

Array of generated video URLs

​
proxy_links
string<uri>[]

Array of proxy video URLs

​
future_links
string<uri>[]

Array of future video URLs for queued requests

​
meta
object

Metadata about the video generation including all parameters used

​
eta
integer

Estimated time for completion in seconds (processing status)

​
message
string

Status message or additional information

​
tip
string

Additional information or tips for the user

​
fetch_result
string<uri>

URL to fetch the result when processing