Skip to main content
POST
/
v1
/
videos
curl --request POST \
  --url https://api.powertokens.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-i2v",
  "prompt": "The portrait gradually starts speaking with subtle head motion.",
  "media": [
    {
      "type": "first_frame",
      "url": "https://example.com/assets/portrait.png"
    },
    {
      "type": "driving_audio",
      "url": "https://example.com/assets/voice.mp3"
    }
  ],
  "seconds": "8",
  "size": "720P"
}
'
{
  "id": "<string>",
  "task_id": "<string>",
  "object": "video",
  "model": "<string>",
  "status": "queued",
  "progress": 123,
  "created_at": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

Ali wan2.7-i2v model.

Available options:
wan2.7-i2v
image
string
required

Compatibility field for single first-frame input. The project maps it to upstream media: [{type: first_frame, url: ...}].

prompt
string

Optional text prompt. When omitted, generation relies entirely on the provided media inputs.

images
string[]

Compatibility field for first-frame plus last-frame input. Must contain exactly 2 items in order: [first_frame, last_frame].

Required array length: 2 elements
media
object[]

Latest multimodal input style for wan2.7-i2v. Use this field for official upstream combinations such as first frame + driving audio or first clip continuation.

seconds
string
default:5

Video duration in string form. Supported values are integer strings from 2 to 15.

size
enum<string>
default:1080P

Output resolution tier for the current project implementation.

Available options:
720P,
1080P

Response

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

id
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.