API docs / Video models

Wan 2.7 (Reference to video) API

Use references to guide subjects and composition.

Model id
wan-video/wan-2.7-r2v
Provider
Wan AI
Output
Video
Price
From 175 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "wan-video/wan-2.7-r2v". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "wan-video/wan-2.7-r2v",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Text prompt for video generation

reference_imagesarray of URLs

Reference images of the character/object to feature in the video (jpg/png/bmp/webp)

Default: []

Up to 10 files · Accepts image/*

reference_videosarray of URLs

Reference videos of the character/object to feature in the video (mp4/mov)

Default: []

Up to 10 files · Accepts video/*

aspect_ratiostring

Default: 16:9

One of: 16:9, 9:16, 1:1, 4:3, 3:4

resolutionstring

Default: 720p

One of: 720p, 1080p

duration_secondsnumber

Duration of the generated video in seconds

Default: 5

Min 2 · Max 10

seednumber

Random seed for reproducible generation. Range: 0-2147483647

negative_promptstring

Negative prompt — describes content that should not appear in the video

Default:

shot_typestring

Default: single

One of: single, multi