> ## Documentation Index > Fetch the complete documentation index at: https://docs.goenhance.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan 3.0 (Reference) > Wan 3.0 driven by reference materials — images, videos, audio, a document or a web page. Refer to them inside the prompt as 图1 / 视频1 / 音频1 (image 1, video 1, audio 1); **the array order is what those numbers refer to**. ⚠️ **This endpoint rejects first/last frames.** The two input modes are mutually exclusive upstream — use [`wan-3-0`](/api-reference/video-generations/wan-3-0) for text-to-video or first/last frame generation. At least one of `ref_imgs` / `ref_videos` / `ref_audios` / `ref_file` / `ref_link` is required. `ref_file` and `ref_link` are mutually exclusive. **Pricing** — per second of generated video, in tokens (USD at $0.02/token). Both wan-3-0 endpoints cost the same: | resolution | tokens/s | USD/s | |---|---|---| | 480p | 2.91 | $0.0582 | | 720p | 5.82 | $0.1164 | | 1080p | 11.64 | $0.2328 | The published per-second rate times the duration is exactly what gets charged. Example: a 5s 720p video costs 29.1 tokens. **Notes on defaults:** `resolution` defaults to `720p` rather than the upstream default of `1080p`. Smart duration (`-1`) is not exposed because the price is only known after generation. Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) to get the generated video. ## OpenAPI ````yaml api-reference/video-generations/openapi-wan-3-0-refs.json POST /api/v1/videos/generations openapi: 3.1.0 info: title: GoEnhance API - HappyHorse 1.1 Reference description: Video generation with HappyHorse 1.1 Reference. version: 1.0.0 servers: - url: https://api.goenhance.ai security: [] paths: /api/v1/videos/generations: post: tags: - VideoGenerations summary: Wan 3.0 Reference to Video description: >- Wan 3.0 driven by reference materials — images, videos, audio, a document or a web page. Refer to them inside the prompt as 图1 / 视频1 / 音频1 (image 1, video 1, audio 1); **the array order is what those numbers refer to**. ⚠️ **This endpoint rejects first/last frames.** The two input modes are mutually exclusive upstream — use [`wan-3-0`](/api-reference/video-generations/wan-3-0) for text-to-video or first/last frame generation. At least one of `ref_imgs` / `ref_videos` / `ref_audios` / `ref_file` / `ref_link` is required. `ref_file` and `ref_link` are mutually exclusive. **Pricing** — per second of generated video, in tokens (USD at $0.02/token). Both wan-3-0 endpoints cost the same: | resolution | tokens/s | USD/s | |---|---|---| | 480p | 2.91 | $0.0582 | | 720p | 5.82 | $0.1164 | | 1080p | 11.64 | $0.2328 | The published per-second rate times the duration is exactly what gets charged. Example: a 5s 720p video costs 29.1 tokens. **Notes on defaults:** `resolution` defaults to `720p` rather than the upstream default of `1080p`. Smart duration (`-1`) is not exposed because the price is only known after generation. Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) to get the generated video. parameters: - name: Authorization in: header description: '' required: false example: '{{Authorization}}' schema: type: string requestBody: content: application/json: schema: type: object properties: model: type: string enum: - wan-3-0-refs description: Model name. Must be `wan-3-0-refs`. prompt: type: string description: >- Text prompt. You can reference each image as `[Image 1]`, `[Image 2]`, etc. ratio: type: string enum: - adaptive - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: adaptive description: >- Output aspect ratio. `aspect_ratio` is accepted as a compatible alias. duration: type: integer minimum: 2 maximum: 30 default: 5 description: Video duration in seconds. Any integer from 2 to 30. resolution: type: string enum: - 480p - 720p - 1080p default: 720p description: >- Output resolution, lowercase like every other video model. `quality` is accepted as a compatible alias. ref_imgs: type: array items: type: string format: uri maxItems: 10 description: >- Reference image URLs, up to 10. Referred to as 图1, 图2, … in array order. ref_videos: type: array items: type: string format: uri maxItems: 5 description: >- Reference video URLs, up to 5 and 15 seconds in total. Referred to as 视频1, 视频2, … in array order. ref_audios: type: array items: type: string format: uri maxItems: 5 description: >- Reference audio URLs, up to 5 and 15 seconds in total. Referred to as 音频1, 音频2, … in array order. ref_file: type: string format: uri description: >- Optional. A single document URL (docx/pptx/pdf/txt/…). Mutually exclusive with ref_link. ref_link: type: string format: uri description: >- Optional. A single public web page URL. Mutually exclusive with ref_file. generate_audio: type: boolean default: true description: >- Whether the output contains an audio track. Enabling it costs no extra. seed: type: integer minimum: 0 maximum: 2147483647 description: Optional. Fixing the seed makes results more reproducible. custom_callback_url: type: string format: uri description: >- Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt. example: https://your-server.com/goenhance/callback required: - model example: model: wan-3-0-refs prompt: 图1 里的角色坐在图2 的椅子上弹吉他，镜头缓缓推近 ref_imgs: - https://your-cdn.com/character.jpg - https://your-cdn.com/chair.png resolution: 720p duration: 5 responses: '200': description: '' content: application/json: schema: type: object properties: code: type: integer msg: type: string data: type: object properties: img_uuid: type: string required: - img_uuid required: - code - msg - data examples: '1': summary: Success value: code: 0 msg: Success data: img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5 '2': summary: Insufficient tokens value: code: 100 msg: tokens is not enough headers: {} '401': description: '' content: application/json: schema: type: object properties: code: type: integer msg: type: string required: - code - msg headers: {} deprecated: false security: [] ````