# Wan v2.6 Reference to Video > Wan 2.6 reference-to-video model. ## Overview - **Endpoint**: `https://fal.run/wan/v2.6/reference-to-video` - **Model ID**: `wan/v2.6/reference-to-video` - **Category**: video-to-video - **Kind**: inference **Tags**: reference-to-video ## Pricing Your request will cost **$0.10** per second for **720p**, **$0.15** per second for **1080p**. For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`prompt`** (`string`, _required_): Use @Video1, @Video2, @Video3 to reference subjects from your videos. Works for people, animals, or objects. For multi-shot prompts: '[0-3s] Shot 1. [3-6s] Shot 2.' Max 800 characters. - Examples: "Dance battle between @Video1 and @Video2." - **`video_urls`** (`list`, _required_): Reference videos for subject consistency (1-3 videos). Videos' FPS must be at least 16 FPS.Reference in prompt as @Video1, @Video2, @Video3. Works for people, animals, or objects. - Array of string - Examples: ["https://v3b.fal.media/files/b/0a86742f/9rVJtQ2ukp9cid8lheutF_output.mp4","https://v3b.fal.media/files/b/0a867424/30OqWXFgHWqOwcP2OUwRx_output.mp4"] - **`aspect_ratio`** (`AspectRatioEnum`, _optional_): The aspect ratio of the generated video. Default value: `"16:9"` - Default: `"16:9"` - Options: `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"` - **`resolution`** (`ResolutionEnum`, _optional_): Video resolution tier. R2V only supports 720p and 1080p (no 480p). Default value: `"1080p"` - Default: `"1080p"` - Options: `"720p"`, `"1080p"` - **`duration`** (`DurationEnum`, _optional_): Duration of the generated video in seconds. R2V supports only 5 or 10 seconds (no 15s). Default value: `"5"` - Default: `"5"` - Options: `"5"`, `"10"` - Examples: "5", "10" - **`negative_prompt`** (`string`, _optional_): Negative prompt to describe content to avoid. Max 500 characters. Default value: `""` - Default: `""` - Examples: "low resolution, error, worst quality, low quality, defects" - **`enable_prompt_expansion`** (`boolean`, _optional_): Whether to enable prompt rewriting using LLM. Default value: `true` - Default: `true` - **`multi_shots`** (`boolean`, _optional_): When true (default), enables intelligent multi-shot segmentation for coherent narrative videos with multiple shots. When false, generates single continuous shot. Only active when enable_prompt_expansion is True. Default value: `true` - Default: `true` - **`seed`** (`integer`, _optional_): Random seed for reproducibility. If None, a random seed is chosen. - **`enable_safety_checker`** (`boolean`, _optional_): If set to true, the safety checker will be enabled. Default value: `true` - Default: `true` - Examples: true **Required Parameters Example**: ```json { "prompt": "Dance battle between @Video1 and @Video2.", "video_urls": [ "https://v3b.fal.media/files/b/0a86742f/9rVJtQ2ukp9cid8lheutF_output.mp4", "https://v3b.fal.media/files/b/0a867424/30OqWXFgHWqOwcP2OUwRx_output.mp4" ] } ``` **Full Example**: ```json { "prompt": "Dance battle between @Video1 and @Video2.", "video_urls": [ "https://v3b.fal.media/files/b/0a86742f/9rVJtQ2ukp9cid8lheutF_output.mp4", "https://v3b.fal.media/files/b/0a867424/30OqWXFgHWqOwcP2OUwRx_output.mp4" ], "aspect_ratio": "16:9", "resolution": "1080p", "duration": "5", "negative_prompt": "low resolution, error, worst quality, low quality, defects", "enable_prompt_expansion": true, "multi_shots": true, "enable_safety_checker": true } ``` ### Output Schema The API returns the following output format: - **`video`** (`VideoFile`, _required_): The generated video file - Examples: {"url":"https://v3b.fal.media/files/b/0a86762b/iDknfPkLFSFwWkyMgJi0U_QIzjwBDQ.mp4","content_type":"video/mp4"} - **`seed`** (`integer`, _required_): The seed used for generation - Examples: 175932751 - **`actual_prompt`** (`string`, _optional_): The actual prompt used if prompt rewriting was enabled - Examples: "Dance battle between Character1 and Character2, cinematic lighting, dynamic camera movement." **Example Response**: ```json { "video": { "url": "https://v3b.fal.media/files/b/0a86762b/iDknfPkLFSFwWkyMgJi0U_QIzjwBDQ.mp4", "content_type": "video/mp4" }, "seed": 175932751, "actual_prompt": "Dance battle between Character1 and Character2, cinematic lighting, dynamic camera movement." } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/wan/v2.6/reference-to-video \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "prompt": "Dance battle between @Video1 and @Video2.", "video_urls": [ "https://v3b.fal.media/files/b/0a86742f/9rVJtQ2ukp9cid8lheutF_output.mp4", "https://v3b.fal.media/files/b/0a867424/30OqWXFgHWqOwcP2OUwRx_output.mp4" ] }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python import fal_client def on_queue_update(update): if isinstance(update, fal_client.InProgress): for log in update.logs: print(log["message"]) result = fal_client.subscribe( "wan/v2.6/reference-to-video", arguments={ "prompt": "Dance battle between @Video1 and @Video2.", "video_urls": ["https://v3b.fal.media/files/b/0a86742f/9rVJtQ2ukp9cid8lheutF_output.mp4", "https://v3b.fal.media/files/b/0a867424/30OqWXFgHWqOwcP2OUwRx_output.mp4"] }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("wan/v2.6/reference-to-video", { input: { prompt: "Dance battle between @Video1 and @Video2.", video_urls: ["https://v3b.fal.media/files/b/0a86742f/9rVJtQ2ukp9cid8lheutF_output.mp4", "https://v3b.fal.media/files/b/0a867424/30OqWXFgHWqOwcP2OUwRx_output.mp4"] }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/wan/v2.6/reference-to-video) - [API Documentation](https://fal.ai/models/wan/v2.6/reference-to-video/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=wan/v2.6/reference-to-video) ### fal.ai Platform - [Platform Documentation](https://docs.fal.ai) - [Python Client](https://docs.fal.ai/clients/python) - [JavaScript Client](https://docs.fal.ai/clients/javascript)