Wan 3.0 Reference-to-Video

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "wan-3-r2v",
    "input": {
      "prompt": "A red fox running through fresh snow at sunrise"
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

10 fields in input, required first.

• promptRequired
  string

  The positive prompt for the generation. Reference media are identified by their array order in the prompt.

• seedOptional
  integer

  The random seed to use for the generation. Must be between 0 and 2147483647. If omitted, a random seed will be used.

• durationOptional
  integerDefault 5

  The duration of the generated media in seconds (2-30s).

• resolutionOptional
  480p, 720p, 1080pDefault 720p

  The resolution of the generated video.

• aspect_ratioOptional
  16:9, 9:16, 1:1, 4:3, 3:4Default 16:9

  The aspect ratio of the generated video.

• enable_audioOptional
  booleanDefault true

  Whether to include audio in the generated video.

• thinking_modeOptional
  booleanDefault false

  Whether to enable deep-thinking mode for complex prompts and richer scene understanding.

• reference_audiosOptional
  array

  Array of reference audio URLs (up to 5). Total input audio duration must not exceed 15 seconds.

• reference_imagesOptional
  array

  Array of reference image URLs (up to 10). At least one reference image, video, or audio is required.

• reference_videosOptional
  array

  Array of reference video URLs (up to 5). Each video must be MP4 or MOV, 1-15 seconds, 240-4096 pixels on each side, no more than 8:1 aspect ratio, and no more than 100 MB. Total input video duration must not exceed 15 seconds. Supports HTTP/HTTPS URLs and temporary OSS URLs.