curl --request POST \
  --url https://api.powertokens.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-r2v",
  "prompt": "Image 1 walks toward the camera and waves with a relaxed smile.",
  "media": [
    {
      "type": "reference_image",
      "url": "https://example.com/assets/subject-reference.png"
    }
  ],
  "seconds": "5",
  "size": "1080P",
  "ratio": "16:9",
  "prompt_extend": true,
  "watermark": false
}
'

{
  "id": "<string>",
  "task_id": "<string>",
  "object": "video",
  "model": "<string>",
  "progress": 123,
  "created_at": 123
}

Alibaba

Wan Reference to Video

Submit an asynchronous Ali wan2.7-r2v generation task.

This capability uses the top-level media array as the public multimodal input. Supported media.type values are reference_image, reference_video, and first_frame.

Current public rules:

prompt is required;
include at least one reference_image or reference_video item;
you may provide at most five reference_image / reference_video items in total;
first_frame is optional and can appear at most once;
size supports only 720P and 1080P;
ratio supports 16:9, 9:16, 1:1, 4:3, and 3:4;
seconds accepts integer strings from 2 to 15, but when any reference_video is included the allowed range is 2 to 10.

Prompt referencing follows the submitted media order. Refer to image references as Image 1, Image 2, and to video references as Video 1, Video 2, counting separately within each media type.

POST

videos

curl --request POST \
  --url https://api.powertokens.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-r2v",
  "prompt": "Image 1 walks toward the camera and waves with a relaxed smile.",
  "media": [
    {
      "type": "reference_image",
      "url": "https://example.com/assets/subject-reference.png"
    }
  ],
  "seconds": "5",
  "size": "1080P",
  "ratio": "16:9",
  "prompt_extend": true,
  "watermark": false
}
'

{
  "id": "<string>",
  "task_id": "<string>",
  "object": "video",
  "model": "<string>",
  "progress": 123,
  "created_at": 123
}

Authorizations

Authorization

string

header

required

Pass Authorization: Bearer <token> in the request header.

Body

application/json

model

enum<string>

required

Ali wan2.7-r2v model.

Available options:

wan2.7-r2v

prompt

string

required

Text prompt describing the desired video. Use Image x and Video x references when multiple reference media items are provided.

media

object[]

required

Public multimodal input for wan2.7-r2v. Include one or more reference_image or reference_video items, optionally plus one first_frame item.

Show child attributes

size

enum<string>

default:1080P

Output resolution tier for the current public implementation.

Available options:

720P,

1080P

seconds

enum<string>

default:5

Video duration (seconds) as a string. Default is "5".Range: [2, 15] for reference videos containing video, [2, 10] for reference videos without video.

Available options:

2,

3,

4,

5,

6,

7,

8,

9,

10,

11,

12,

13,

14,

15

ratio

enum<string>

default:16:9

Output aspect ratio.

Available options:

16:9,

9:16,

1:1,

4:3,

3:4

negative_prompt

string

Optional negative prompt describing content that should not appear in the generated video.

prompt_extend

boolean

Whether to enable prompt rewriting. The default value is true.

watermark

boolean

default:false

Whether to add a watermark. The default value is false.

seed

integer

Random seed. If omitted, the system generates one automatically.

Required range: 0 <= x <= 2147483647

Response

Submission successful. Returns the unified OpenAI-style video task object.

string

Public task ID.

task_id

string

Public task ID alias.

object

string

Example:

"video"

model

string

Model name.

status

enum<string>

Unified video task status.

Available options:

queued,

in_progress,

completed,

failed,

unknown

progress

integer

Task progress percentage.

created_at

integer<int64>

Unix timestamp in seconds.

MiniMax-Hailuo-2.3-Fast Image to Video

Wan Text to Video