Generate video guided by reference images, video, and audio with Wan 3.0. Keep characters and style consistent across a scene. Pay per generation.
About this model
Wan 3.0 Reference to Video generates a video guided by a text prompt plus up to 10 reference images, 5 reference videos, and 5 reference audios, letting you keep characters, style, and sound consistent across a generated scene. Reference media are identified by their order in each array, so the prompt can address "the first reference image" or "the person in the reference video" directly. Choose 480p, 720p, or 1080p output, five aspect ratios, and a duration from 2 to 30 seconds; when reference videos are supplied, their total duration plus the generated output must stay within 30 seconds. For a plain text-to-video generation with no reference media, see Wan 3.0 Text to Video; for animating a single source image, see Wan 3.0 Image to Video. For the higher-fidelity Prime tier, see Wan 3.0 Prime Reference to Video. For a bolder, higher-contrast take on the same request shape, see Wan 3.0 Spicy Reference to Video.
Cost analysis
| Provider | Cost | Notes |
|---|---|---|
| muapiapp | From $0.10 per generation (720p, 2s) up to $6.00 (1080p, 30s) | Pay-per-generation, priced by resolution and duration, no subscription required. |
| Fal.ai | Not available | Wan 3.0 is not listed on Fal.ai at this time. |
| Replicate | Not available | Wan 3.0 is not listed on Replicate at this time. |
Pay-per-generation, priced by resolution and duration, no subscription required.
Wan 3.0 is not listed on Fal.ai at this time.
Wan 3.0 is not listed on Replicate at this time.
* Competitor pricing is estimated based on similar model architectures and usage tiers.
Configuration schema
| Parameter | Type | Description | Default |
|---|---|---|---|
| Prompt | string | Describe the video you want to create. Reference media are identified by their array order. | The two people from the reference images meet on the rainy street shown in the reference video. |
| Reference Image URLs | array | Up to 10 reference images for visual coherence guidance. | undefined |
| Reference Video URLs | array | Up to 5 reference video clips (MP4/MOV, 1-15s each); total reference + generated duration must not exceed 30s. | undefined |
| Reference Audio URLs | array | Up to 5 reference audio clips (total duration up to 15s) for soundtrack synchronization. | undefined |
| Resolution | Enum (3 options) | Output video resolution. | 720p |
| Aspect Ratio | Enum (5 options) | Output video frame dimensions. | 16:9 |
| Duration | integer | Video length in seconds. | 5 |
| Thinking Mode | boolean | Enable deep-thinking mode for complex scene understanding. | false |
| Enable Audio | boolean | Include a generated audio track with the video. | true |
| Seed | integer | Random seed for reproducibility. Use -1 for a random seed. | -1 |
Describe the video you want to create. Reference media are identified by their array order.
The two people from the reference images meet on the rainy street shown in the reference video.Up to 10 reference images for visual coherence guidance.
undefinedUp to 5 reference video clips (MP4/MOV, 1-15s each); total reference + generated duration must not exceed 30s.
undefinedUp to 5 reference audio clips (total duration up to 15s) for soundtrack synchronization.
undefinedOutput video resolution.
720pOutput video frame dimensions.
16:9Video length in seconds.
5Enable deep-thinking mode for complex scene understanding.
falseInclude a generated audio track with the video.
trueRandom seed for reproducibility. Use -1 for a random seed.
-1Developer documentation
Write the prompt: Describe the scene, referring to reference media by their array order (e.g. "the person from the first reference image").
Attach reference media: Provide up to 10 URLs in images_list, up to 5 in videos_list, and up to 5 in audios_list.
Set the output shape: Choose resolution (480p, 720p, 1080p), aspect_ratio, and duration (2-30 seconds, capped so reference-video duration plus output stays at or under 30 seconds).
Tune generation: Enable thinking_mode for complex multi-reference scenes, and set enable_audio to false for a silent video.
Submit and poll: Send the request with your Muapi API key, store the returned request_id, then poll the prediction result endpoint or supply a webhook_url.
curl -X POST https://api.muapi.ai/api/v1/wan3.0-reference-to-video \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "The person from the reference image walks into the room shown in the reference video.",
"images_list": ["https://example.com/character.jpg"],
"videos_list": ["https://example.com/room.mp4"],
"resolution": "720p",
"duration": 5
}'
Frequently asked
It generates a video guided by a prompt plus reference images, videos, and audio, keeping characters, style, and sound consistent with the supplied references.
Up to 10 reference images, 5 reference videos, and 5 reference audios per request.
Reference media are identified by their order in each array, so the prompt can refer to "the first reference image" or similar ordinal phrasing.
Yes. When reference videos are supplied, their total input duration plus the generated output duration must not exceed 30 seconds.
480p, 720p, and 1080p, with five aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4).
Pricing scales with resolution and duration, and the completed task response includes the exact charge for that generation.