Wan - 2.2 A14B Text to Video Turbo
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-2-a14b-text-to-video-turbo for this endpoint Default:"wan/2-2-a14b-text-to-video-turbo"。 Allowed values:wan/2-2-a14b-text-to-video-turbo。 Example:wan/2-2-a14b-text-to-video-turbo。 |
prompt | string | Yes | Prompt required by the ModelFold gateway; at most 2000 characters. The text prompt to guide video generation. (Max length: 5000 characters) maxLength: 2000. Example:Drone shot, fast traversal, starting inside a cracked, frosty circular pipe. The camera bursts upward through the pipe to reveal a vast polar landscape bathed in golden sunrise light. Workers in orange suits operate steaming machinery. The camera tilts up, revealing the scene from the perspective of a rising hot air balloon. It continues ascending into a glowing sky, the balloon trailing steam and displaying the letters "ModelFold AI" as it rises into breathtaking polar majesty.。 |
resolution | string | No | Resolution of the generated video (480p or 720p). Default value: "720p" Default:"720p"。 Allowed values:480p / 720p。 Example:720p。 |
aspect_ratio | string | No | Aspect ratio of the generated video (16:9 or 9:16). Default value: "16:9" Default:"16:9"。 Allowed values:16:9 / 9:16。 Example:16:9。 |
enable_prompt_expansion | boolean | No | Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. (Boolean value (true/false)) Example:false。 |
seed | number | No | Optional. Omit for a random seed. minimum: 0. maximum: 2147483647. |
acceleration | string | No | Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'none'. Default value: "none" Default:"none"。 Allowed values:none / regular。 Example:none。 |
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-2-a14b-text-to-video-turbo",
"prompt": "Drone shot, fast traversal, starting inside a cracked, frosty circular pipe. The camera bursts upward through the pipe to reveal a vast polar landscape bathed in golden sunrise light. Workers in orange suits operate steaming machinery. The camera tilts up, revealing the scene from the perspective of a rising hot air balloon. It continues ascending into a glowing sky, the balloon trailing steam and displaying the letters \"ModelFold AI\" as it rises into breathtaking polar majesty.",
"resolution": "720p",
"aspect_ratio": "16:9",
"acceleration": "none"
}'json
{
"model": "wan/2-2-a14b-text-to-video-turbo",
"prompt": "Drone shot, fast traversal, starting inside a cracked, frosty circular pipe. The camera bursts upward through the pipe to reveal a vast polar landscape bathed in golden sunrise light. Workers in orange suits operate steaming machinery. The camera tilts up, revealing the scene from the perspective of a rising hot air balloon. It continues ascending into a glowing sky, the balloon trailing steam and displaying the letters \"ModelFold AI\" as it rises into breathtaking polar majesty.",
"resolution": "720p",
"aspect_ratio": "16:9",
"acceleration": "none"
}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": {}
}