Skip to main content
POST

Authorization

string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Mode Routing

wan2.7 is a unified entry for text-to-video and image-to-video. The backend automatically determines the mode based on the incoming parameters. Both modes are billed identically:

Request Parameters

string
required
Video generation model name, fixed as wan2.7
string
Video content description, up to 5000 characters
  • Text-to-Video mode (when no image/video provided): required
  • Image-to-Video mode: optional, but recommended to guide camera movement and actions
Example: "A cat chasing butterflies on the grass, bright sunshine, slow motion"
array<string>
Image URL array. Providing it automatically enters Image-to-Video mode
  • 1 image: first-frame to video
  • 2 images: first-last frame to video (1st = first frame, 2nd = last frame)
Use either this or image_with_roles
image_urls conflicts with audio_url; they cannot be provided at the same time
array<object>
Image array with roles, alternative to image_urls, used to precisely specify the role of each imageFields for each object:
  • url (string): image URL (supports http/https)
  • role (string): image role, first_frame / last_frame, default first_frame
Example:
image_with_roles conflicts with audio_url; they cannot be provided at the same time
array<string>
Video URL array. Providing it enters video continuation mode (only the 1st video is used)
video_urls conflicts with audio_url; they cannot be provided at the same time
Video constraints:
  • Format: mp4, mov
  • Duration: 2–10s
  • Resolution: width and height in the range [240, 4096] pixels
  • Aspect ratio: 1:8 – 8:1
  • File size: up to 100MB
string
Negative prompt describing unwanted content, up to 500 charactersExample: "blurry, distorted, low quality"
string
default:"1080P"
Video resolutionOptions:
  • 720P - Standard
  • 1080P - High definition (default)
integer
default:"5"
Video duration (seconds)Supported range: 2 ~ 15 secondsDefault: 5
string
default:"16:9"
Aspect ratio, only effective in Text-to-Video mode (when no image/video provided)Supported formats:
  • 16:9 - Landscape widescreen (default)
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Landscape
  • 3:4 - Portrait
This parameter is ignored in Image-to-Video mode; the aspect ratio is determined automatically by the input image
string
Custom audio URL
  • Text-to-Video mode: used as background music
  • Image-to-Video mode: used as driving audio, synchronized with on-screen actions
Format: wav / mp3, duration 2-30 seconds, file size ≤ 15MB
audio_url conflicts with video_urls, image_urls, and image_with_roles; they cannot be provided at the same time
boolean
default:"true"
Whether to enable intelligent prompt rewritingSignificantly improves results for short prompts, but increases processing timeDefault: true
boolean
default:"false"
Whether to add “AI Generated” watermark to the generated video
  • true: add watermark
  • false: no watermark (default)
integer
Seed integer used to control the randomness of generated contentValue range: integer ≥0
  • For identical requests, the model generates different results when receiving different seed values (e.g., omitting seed)
  • For identical requests, the model generates similar results when receiving the same seed value, but exact consistency is not guaranteed

Response

integer
Response status code, 200 on success
array
Response data array

Use Cases

Case 1: Text-to-Video (Simplest Request)

Case 2: Text-to-Video (Full Parameters)

Case 3: First-Frame to Video

Case 4: First-Last Frame to Video

With 2 images: the 1st is the first frame, the 2nd is the last frame. You can also use image_with_roles for precise specification.

Case 5: Video Continuation

Case 6: Image + Driving Audio

Mode Selection Guide

Query Task ResultsVideo generation is an async task that returns a task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.