> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan 3.0 Reference to Video > Guide Wan 3.0 video scenes with image, video, and audio references, combining multiple sources into a new visual sequence. 1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`. 2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails. # Wan 3.0 Reference to Video Guide Wan 3.0 video scenes with image, video, and audio references, combining multiple sources into a new visual sequence. ## Available Models * **alibaba/wan-3.0/reference-to-video** - Generate a new video guided by reference material and a prompt. ## Duration Options * **2-30 seconds** - Set `duration` as an integer. Default: **5 seconds**. ## Key Features * Use image, video, audio, document, or webpage references to guide a new scene. * Choose from `480p`, `720p`, `1080p` output resolutions. * Control audio generation with `audio`; it defaults to `true`. ## Advanced Parameters Set `model` and optional `callback_url` at the request root. Place the parameters below inside `input`. Send only the input fields supported by this workflow. Unsupported `input` fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials. ### Prompt * `prompt`: Required. Describe the scene and desired motion. * The prompt must not be blank when supplied. Maximum length: **20,000 characters**. ### Reference Inputs * At least one reference type is required in addition to `prompt`. Audio can be the only reference type. * Do not combine `reference_file_urls` with `reference_link_urls`. * `reference_image_urls`: Optional; provide 1-10 images. * `reference_video_urls`: Optional; provide 1-5 videos. * `reference_audio_urls`: Optional; provide 1-5 audio files. * `reference_file_urls`: Optional; provide exactly 1 document. * `reference_link_urls`: Optional; provide exactly 1 webpage. ### Resolution * `resolution`: `480p`, `720p`, `1080p`. Default: `720p`. ### Aspect Ratio * `aspect_ratio`: `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. Default: `adaptive`. ### Audio * `audio`: Set to `true` to enable generated audio, or `false` to disable it. Default: `true`. ### Seed * `seed` is optional. Supply an integer from `0` to `2147483647`. ### Safety Checker * `enable_safety_checker` is optional. Set it to `true` or `false` to control safety checking. Default: `true`. ## Pricing Pricing depends on the selected model and applicable output settings. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails. ## OpenAPI ````yaml api-manual/video-series/alibaba-wan-3-0-reference-to-video.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Wan 3.0 Reference to Video description: >- Guide Wan 3.0 video scenes with image, video, and audio references, combining multiple sources into a new visual sequence. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Video Series summary: Wan 3.0 Reference to Video description: >- Send only the fields shown for this workflow. Parameters from other workflows are rejected before credits are deducted. When supplied, prompt and text must not be blank. Input URL fields require HTTP(S) URLs with a hostname and no embedded credentials. A prompt and at least one image, video, audio, document, or webpage reference are required. Audio can be the only reference type. Document and webpage references cannot be combined. operationId: submit_alibaba_wan_3_0_reference_to_video requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string enum: - alibaba/wan-3.0/reference-to-video example: alibaba/wan-3.0/reference-to-video description: >- Vidgo public model ID. Must be `alibaba/wan-3.0/reference-to-video`. input: type: object additionalProperties: false properties: prompt: type: string maxLength: 20000 minLength: 1 description: Prompt. reference_image_urls: type: array minItems: 1 maxItems: 10 items: type: string format: uri description: Reference image urls. description: Reference image urls. reference_video_urls: type: array minItems: 1 maxItems: 5 items: type: string format: uri description: Reference video urls. description: Reference video urls. reference_audio_urls: type: array minItems: 1 maxItems: 5 items: type: string format: uri description: Reference audio urls. description: >- One to five public audio URLs. Audio may be the only reference type; prompt is still required. reference_file_urls: type: array minItems: 1 maxItems: 1 items: type: string format: uri description: Reference file urls. description: Reference file urls. reference_link_urls: type: array minItems: 1 maxItems: 1 items: type: string format: uri description: Reference link urls. description: Reference link urls. resolution: type: string enum: - 480p - 720p - 1080p default: 720p description: Resolution. aspect_ratio: type: string enum: - adaptive - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: adaptive description: Aspect ratio. duration: type: integer minimum: 2 maximum: 30 default: 5 description: Duration. audio: type: boolean default: true description: Audio. seed: type: integer minimum: 0 maximum: 2147483647 description: Seed. enable_safety_checker: type: boolean default: true description: Enable safety checker. allOf: - anyOf: - required: - reference_file_urls properties: reference_file_urls: minItems: 1 - required: - reference_image_urls properties: reference_image_urls: minItems: 1 - required: - reference_link_urls properties: reference_link_urls: minItems: 1 - required: - reference_video_urls properties: reference_video_urls: minItems: 1 - required: - reference_audio_urls properties: reference_audio_urls: minItems: 1 - not: required: - reference_file_urls - reference_link_urls required: - prompt callback_url: type: string nullable: true description: >- Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks. description: >- Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected. examples: basic: summary: Basic workflow value: model: alibaba/wan-3.0/reference-to-video input: prompt: >- A quiet forest under soft morning light, with natural detail. resolution: 720p aspect_ratio: adaptive duration: 5 audio: true enable_safety_checker: true reference_image_urls: - https://example.com/image.png callback: summary: Receive a completion callback value: model: alibaba/wan-3.0/reference-to-video input: prompt: >- A quiet forest under soft morning light, with natural detail. resolution: 720p aspect_ratio: adaptive duration: 5 audio: true enable_safety_checker: true reference_image_urls: - https://example.com/image.png callback_url: https://your-domain.com/callback responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: task-unified-example status: running created_time: '2026-09-10T08:00:00' '400': description: >- Invalid input, unsupported tier, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Unable to create the upstream generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Model configuration or capability is not approved content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````