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
| Name | Type | Details |
|---|---|---|
promptrequired | string | Text prompt for video generation |
reference_images | array 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_videos | array of URLs | Reference videos of the character/object to feature in the video (mp4/mov) Default: Up to 10 files · Accepts video/* |
aspect_ratio | string | Default: One of: 16:9, 9:16, 1:1, 4:3, 3:4 |
resolution | string | Default: One of: 720p, 1080p |
duration_seconds | number | Duration of the generated video in seconds Default: Min 2 · Max 10 |
seed | number | Random seed for reproducible generation. Range: 0-2147483647 |
negative_prompt | string | Negative prompt — describes content that should not appear in the video Default: |
shot_type | string | Default: One of: single, multi |