> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Wan3.0 Text-to-Video > - Generates video from `prompt` only, **no media input is accepted** - Videos of up to **30 seconds**, `duration: -1` smart duration supported - For first-and-last-frame control use [Wan3.0 Image-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-image-to-video); for reference material use [Wan3.0 Reference-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-reference-video) - Asynchronous processing mode, use the returned task ID to [query status](/en/api-manual/task-management/get-task-detail) - Generated video links are valid for 24 hours, please save them promptly ## Billing - **Billing formula**: billed duration = input video duration + output video duration, billed per second - **Resolution multiplier**: `480p` = 1x (baseline), `720p` = 2x, `1080p` = 4x - Reference images, reference audio, reference files and web page links are **not billed** - When `duration` is `-1` (smart duration), credits are pre-authorized at the `30`-second cap; once the task succeeds it is settled against the actual output duration and the difference is refunded automatically - Turning the `audio` track on or off **costs the same** - **Failed tasks are not billed**, the frozen credits are refunded in full ## OpenAPI ````yaml en/api-manual/video-series/wan3.0/wan3.0-text-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 Text-to-Video API description: >- Wan 3.0 text-to-video, generating videos of up to 30 seconds from a text prompt alone license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Video Generation description: AI video generation endpoints paths: /v1/videos/generations: post: tags: - Video Generation summary: Wan3.0 Text-to-Video description: >- - Generates video from `prompt` only, **no media input is accepted** - Videos of up to **30 seconds**, `duration: -1` smart duration supported - For first-and-last-frame control use [Wan3.0 Image-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-image-to-video); for reference material use [Wan3.0 Reference-to-Video](/en/api-manual/video-series/wan3.0/wan3.0-reference-video) - Asynchronous processing mode, use the returned task ID to [query status](/en/api-manual/task-management/get-task-detail) - Generated video links are valid for 24 hours, please save them promptly ## Billing - **Billing formula**: billed duration = input video duration + output video duration, billed per second - **Resolution multiplier**: `480p` = 1x (baseline), `720p` = 2x, `1080p` = 4x - Reference images, reference audio, reference files and web page links are **not billed** - When `duration` is `-1` (smart duration), credits are pre-authorized at the `30`-second cap; once the task succeeds it is settled against the actual output duration and the difference is refunded automatically - Turning the `audio` track on or off **costs the same** - **Failed tasks are not billed**, the frozen credits are refunded in full operationId: createWan30TextToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: basic: summary: Basic text-to-video value: model: wan3.0-text-to-video prompt: >- A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work. duration: 5 quality: 720p aspect_ratio: '16:9' generate_audio: true smart_duration: summary: Smart duration + 1080p value: model: wan3.0-text-to-video prompt: >- A high-end smart glasses product ad, minimalist and futuristic, the camera glides over the lens and hinge details and finally settles on the brand logo. duration: -1 quality: 1080p aspect_ratio: '16:9' silent: summary: Silent video value: model: wan3.0-text-to-video prompt: >- An aerial shot sweeps over snow-capped mountains at dawn, a sea of clouds drifting slowly through the valleys. duration: 8 quality: 480p generate_audio: false responses: '200': description: Video generation task created successfully content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_parameter message: Invalid request parameters type: invalid_request_error '401': description: Unauthenticated, invalid or expired token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Insufficient quota, recharge required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Access denied content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: wan3.0-text-to-video' type: invalid_request_error '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - prompt properties: model: type: string description: Model name, fixed to `wan3.0-text-to-video` enum: - wan3.0-text-to-video example: wan3.0-text-to-video default: wan3.0-text-to-video prompt: type: string description: >- Text prompt for video generation. Chinese and English are supported, **each Chinese character / letter counts as 1 character**, maximum length `20000` characters; anything beyond that is truncated automatically (no error) **Note:** this model is pure text-to-video and accepts no media input. example: >- A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work. duration: type: integer description: >- Duration of the generated video in seconds, defaults to `5` **Accepted values:** - Any integer between `2` and `30` - `-1`: smart duration, the model decides the output length from the prompt and the input material **How smart duration is billed:** the output length cannot be known at submission time, so credits are pre-authorized at the `30`-second **cap**; once the task succeeds it is settled against the actual output duration and the excess hold is released automatically. If your balance cannot cover the capped hold, pass an explicit number of seconds instead. default: 5 example: 5 quality: type: string description: >- Video resolution, defaults to `720p` **Options:** - `480p`: lower definition, lowest price (billing baseline) - `720p`: standard definition, this is the default, 2x the price of `480p` - `1080p`: high definition, 4x the price of `480p` enum: - 480p - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: >- Video aspect ratio, defaults to `adaptive` **Options:** - `adaptive`: adaptive, the model recommends a suitable aspect ratio based on the input material's ratio and the intent of the prompt, this is the default - `16:9` (landscape), `9:16` (portrait), `1:1` (square), `4:3`, `3:4` enum: - adaptive - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' default: adaptive example: '16:9' generate_audio: type: boolean description: >- Whether the output video contains an audio track, defaults to `true` **Options:** - `true`: the output video contains sound (voices, sound effects, background music), this is the default - `false`: silent video output **Sound on and sound off cost the same**, there is no extra charge. default: true example: true seed: type: integer description: >- Random seed, used to reproduce generation results, random by default **Notes:** - Range: `0` ~ `2147483647` - Fixing the seed reduces variation when iterating on prompts and improves reproducibility minimum: 0 maximum: 2147483647 example: 42 callback_url: type: string description: >- HTTPS callback URL for task completion **Callback timing:** - Triggered when the task is completed, failed, or cancelled - Sent after billing confirmation is complete **Security restrictions:** - Only HTTPS protocol is supported - Callbacks to private IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - URL length must not exceed `2048` characters **Callback mechanism:** - Timeout: `10` seconds - Up to `3` retries after failure (at `1`/`2`/`4` seconds after failure respectively) - Callback response body format is consistent with the task query endpoint response format - A 2xx status code is considered successful; other status codes trigger retries format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1761313744 id: type: string description: Task ID example: task-unified-1774857405-abc123 model: type: string description: Actual model name used example: wan3.0-text-to-video object: type: string enum: - video.generation.task description: Specific task type progress: type: integer description: Task progress percentage (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Task status enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Video task details type: type: string enum: - text - image - audio - video description: Task output type example: video usage: $ref: '#/components/schemas/VideoUsage' description: Usage and billing information ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Error code identifier message: type: string description: Error description type: type: string description: Error type VideoTaskInfo: type: object properties: can_cancel: type: boolean description: Whether the task can be cancelled example: true estimated_time: type: integer description: Estimated completion time (seconds) minimum: 0 example: 165 video_duration: type: integer description: Video duration (seconds) example: 8 VideoUsage: type: object description: Usage and billing information properties: billing_rule: type: string description: Billing rule enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Estimated credits consumed minimum: 0 example: 50 user_group: type: string description: User group category example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##All endpoints require Bearer Token authentication## **Get API Key:** Visit the [API Key Management Page](https://evolink.ai/dashboard/keys) to obtain your API Key **Add to request header:** ``` Authorization: Bearer YOUR_API_KEY ``` ```` > ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Query Task Status > Query the status, progress, and result information of asynchronous tasks by task ID ## OpenAPI ````yaml en/api-manual/task-management/get-task-detail.json get /v1/tasks/{task_id} openapi: 3.1.0 info: title: Get Task Details API description: >- Query the status, progress, and result information of asynchronous tasks by task ID license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production environment security: - bearerAuth: [] tags: - name: Task Management description: Asynchronous task management related APIs paths: /v1/tasks/{task_id}: get: tags: - Task Management summary: Query Task Status description: >- Query the status, progress, and result information of asynchronous tasks by task ID operationId: getTaskDetail parameters: - name: task_id in: path required: true schema: type: string description: >- Task ID, ignore {} when querying, append the id from the async task response body at the end of the path example: task-unified-1756817821-4x3rx6ny responses: '200': description: Task status details content: application/json: schema: $ref: '#/components/schemas/TaskDetailResponse' '400': description: Request parameter error, format error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_task_id message: Invalid task ID format, must start with 'task-unified-' type: invalid_request_error param: task_id '401': description: Unauthenticated, token invalid or expired content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Authentication required type: authentication_error '402': description: Insufficient quota, recharge required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: quota_exceeded message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: No permission to access content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: permission_denied message: You don't have permission to access this task type: invalid_request_error '404': description: Resource does not exist content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: task_not_found message: The requested task could not be found type: invalid_request_error '429': description: Request rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Rate limit exceeded type: evo_api_error '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Failed to retrieve task status type: api_error components: schemas: TaskDetailResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1756817821 id: type: string description: Task ID example: task-unified-1756817821-4x3rx6ny model: type: string description: Model used example: wan3.0-text-to-video object: type: string description: Task type enum: - image.generation.task - video.generation.task - audio.generation.task example: image.generation.task progress: type: integer minimum: 0 maximum: 100 description: Task progress percentage example: 100 results: type: array items: type: string format: uri description: Task result list (provided when completed) example: - http://example.com/image.jpg status: type: string description: Task status enum: - pending - processing - completed - failed example: completed error: type: object nullable: true description: >- Error information when the task fails (only present when status is "failed"). Note: error.code here is a string-type business error code, different from HTTP status codes. See the Error Codes Reference for the complete list. properties: code: type: string description: Business error code (string type) example: content_policy_violation message: type: string description: User-friendly error description with troubleshooting tips example: |- Content policy violation. Your request was blocked by safety filters. type: type: string description: Error type identifier, always "task_error" example: task_error task_info: type: object description: Task detailed information properties: can_cancel: type: boolean description: Whether the task can be cancelled example: false type: type: string description: Task type enum: - image - video - audio - text example: image ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Error code (string type) example: invalid_task_id message: type: string description: Error description message example: Invalid task ID format type: type: string description: Error type example: invalid_request_error param: type: string description: Related parameter name example: task_id securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##All APIs require Bearer Token authentication## **Get API Key:** Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to get your API Key **Add to request header:** ``` Authorization: Bearer YOUR_API_KEY ``` ````