> ## Documentation Index > Fetch the complete documentation index at: https://docs.powertokens.ai/llms.txt > Use this file to discover all available pages before exploring further. # Vidu Text-to-Video viduq3-turbo > Convert text prompts to videos using Vidu models. After submission, query status via `GET /vidu/v1/videos/{task_id}`. Uses model viduq3-turbo. ## OpenAPI ````yaml api-reference/en/zmodelVideo/vidu/viduq3-turbo-text-to-video.json POST /vidu/ent/v2/text2video openapi: 3.0.1 info: title: Vidu Text-to-Video (viduq3-turbo) version: 1.0.0 servers: - url: https://api.powertokens.ai security: [] paths: /vidu/ent/v2/text2video: post: summary: Vidu Text-to-Video (viduq3-turbo) description: >- Convert text prompts to videos using Vidu models. After submission, query status via `GET /vidu/v1/videos/{task_id}`. Uses model viduq3-turbo. operationId: viduTextToVideoEnViduq3Turbo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TextToVideoRequest' examples: basic_example: summary: Basic text-to-video example value: model: viduq3-turbo prompt: A small cat running on grass, sunny day duration: 5 aspect_ratio: '16:9' resolution: 720p audio_video_sync_example: summary: Audio-visual synchronization example (q3 models only) value: model: viduq3-turbo prompt: 'A person speaking: Hello World' duration: 5 audio: true aspect_ratio: '16:9' resolution: 720p responses: '200': description: Submission successful, returns a video task object. content: application/json: schema: $ref: '#/components/schemas/TextToVideoResponse' examples: success: summary: Submission successful value: task_id: your_task_id_here state: created model: viduq3-turbo prompt: >- In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene. duration: 5 seed: 123456789 aspect_ratio: '16:9' resolution: 720p payload: '' credits: 10 off_peak: false created_at: '2025-01-01T15:41:31.968916Z' '400': description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_request: summary: Invalid parameters value: code: bad_request_body message: Request body format error or invalid field values data: null '401': description: Authentication failed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: summary: Unauthorized value: code: access_denied message: Invalid token data: null '429': description: Rate limit exceeded or insufficient quota. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: quota_exceeded: summary: Insufficient quota value: code: insufficient_user_quota message: Insufficient account quota, please try again later data: null '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: server_error: summary: Server error value: code: internal_server_error message: Internal server error, please try again later data: null security: - BearerAuth: [] components: schemas: TextToVideoRequest: type: object required: - model - prompt properties: model: type: string enum: - viduq3-turbo description: >- Model name. - **viduq3-turbo**: Compared to viduq3-pro, the generation speed is faster prompt: type: string maxLength: 5000 description: >- Text prompt. A textual description for video generation, with a maximum length of 5000 characters. duration: type: integer description: |- Video duration. Default values vary by model: - **viduq3-pro, viduq3-turbo**: default 5s, available: 1-16 minimum: 1 maximum: 16 default: 5 seed: type: integer description: |- Random seed. - Defaults to a random seed number - Manually set values will override the default random seed aspect_ratio: type: string enum: - '16:9' - '9:16' - '3:4' - '4:3' - '1:1' description: |- The aspect ratio of the output video. Defaults to 16:9. **Note**: 3:4 and 4:3 only support q3 model. default: '16:9' resolution: type: string enum: - 540p - 720p - 1080p description: >- Resolution. Default values vary by model & duration: - **viduq3-pro, viduq3-turbo (1-16s)**: default 720p, available: 540p, 720p, 1080p audio: type: boolean description: >- Whether to use direct audio-video generation capability. Default: true. - **false**: No direct audio-video generation, outputs silent video - **true**: Requires audio-video synchronization, outputs video with sound (including dialogue and sound effects) **Note**: Only the q3 models supports this parameter. default: true payload: type: string maxLength: 1048576 description: >- Transparent transmission parameters. No processing, only data transmission, with a maximum length of 1048576 characters. off_peak: type: boolean description: >- Off peak mode. Defaults to false. - **true**: Off peak generate mode - **false**: Normal generate mode The off_peak mode consumes lower points, please refer to the details Pricing. Tasks submitted in off peak mode will be generated within 48 hours. Tasks that are not completed will be automatically cancelled and their points will be refunded. We also support cancel off_peak tasks. default: false callback_url: type: string description: >- Callback. When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the GET Generation API. The "status" in the callback response includes the following states: - **processing**: Task is being processed. - **success**: Task is completed (if sending fails, it will retry the callback three times). - **failed**: Task failed (if sending fails, it will retry the callback three times). watermark: type: boolean description: >- Whether to add a watermark. - **true**: Add watermark - **false**: Do not add watermark Note 1: Currently the watermark content is fixed, default is no watermark Note 2: You can retrieve watermarked video content through the watermarked_url parameter in the query task API default: false wm_position: type: integer description: |- Watermark position on the image. Options: - **1**: Top left - **2**: Top right - **3**: Bottom right - **4**: Bottom left Default: 3 default: 3 enum: - 1 - 2 - 3 - 4 minimum: 1 maximum: 4 x-options: - label: Top Left value: 1 - label: Top Right value: 2 - label: Bottom Right value: 3 - label: Bottom Left value: 4 wm_url: type: string description: >- Watermark image URL. When not specified, the default watermark is used. meta_data: type: string description: >- Metadata identifier, a JSON format string used as a passthrough field. You can customize the format or use the example format below: ```json { "Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2" } ``` When this parameter is empty, the Vidu-generated metadata identifier is used by default. TextToVideoResponse: type: object properties: task_id: type: string description: Task ID. state: type: string enum: - created - queueing - processing - success - failed description: |- Task processing state: - **created**: Task created successfully - **queueing**: Task in queue - **processing**: Task processing - **success**: Generation successful - **failed**: Task failed model: type: string description: Model parameter used for this call. prompt: type: string description: Text prompt used for this call. duration: type: integer description: Video duration parameter used for this call. seed: type: integer description: Random seed parameter used for this call. aspect_ratio: type: string description: Aspect ratio parameter used for this call. resolution: type: string description: Resolution parameter used for this call. payload: type: string description: Payload parameter used for this call. credits: type: integer description: Credits consumed for this call. off_peak: type: boolean description: Off-peak mode parameter used for this call. created_at: type: string format: date-time description: Task creation time. watermark: type: boolean description: 本次提交任务是否使用水印 ErrorResponse: type: object properties: code: type: string description: Error code. message: type: string description: Error description message. data: type: object nullable: true description: Additional error data (optional). securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Pass `Authorization: Bearer ` in the request header.' ````