Seedance 2.5 Text-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": "seedance-25-t2v",
    "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

8 fields in input, required first.

• promptRequired
  string

  Describe the scene, action, camera movement, and mood for the video.

• durationOptional
  integerDefault 5

  The duration of the generated video in seconds (4-30s).

• resolutionOptional
  480p, 720p, 1080p, 4kDefault 720p

  The output video resolution.

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

  The aspect ratio of the generated video.

• generate_audioOptional
  booleanDefault true

  Whether to generate native audio synchronized with the output video. Defaults to true.

• reference_audiosOptional
  array

  Reference audio URLs (total length must not exceed 30 seconds).

• reference_imagesOptional
  array

  Reference image URLs to guide visual style, characters, or scene composition.

• reference_videosOptional
  array

  Reference video URLs (total length must not exceed 30 seconds).