Skip to main content
POST
/
video
/
text2video_ultra
Generate HD video from text prompt
curl --request POST \
  --url https://modelslab.com/api/v6/video/text2video_ultra \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "<string>",
  "model_id": "wan2.1",
  "prompt": "<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,
  "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>"
}

​
Text to Video Ultra

Generate HD videos from text descriptions.

​
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/text2video_ultra' \

​
Body

json
{
    "key":"",
    "prompt":"Space Station in space",
    "negative_prompt":"low quality",
    "model_id": "wan2.1",
    "resolution":480,
    "num_frames":92,
    "num_inference_steps":8,
    "guidance_scale": 1.0,
    "shift_sample":3,
    "fps":18,
    "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

​
negative_prompt
string

Items you don't want in the video

​
seed
integer | null

Seed for reproducible results

​
resolution
integer

Resolution of the generated output

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

Number of frames in the video

​
num_inference_steps
integer
default:25

Number of denoising steps

Required range: x <= 30
​
guidance_scale
number

Scale for classifier-free guidance

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

Frames per second rate

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

Portrait mode gives output in 9:16 aspect ratio.

​
sample_shift
integer
default:5

Controls the sampling shift in the generation process

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

Store in temporary storage

​
webhook
string<uri>

Webhook URL for completion notification

​
track_id
string

Unique ID for webhook tracking

Response

HD 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

⌘I