---
title: "POST /proxy/vidu/text2video"
method: POST
path: "/proxy/vidu/text2video"
tags: ["API Nodes", "Released"]
---

# POST /proxy/vidu/text2video

`POST /proxy/vidu/text2video`

## Request body

- ViduTaskRequest
  - `aspect_ratio` string
  - `audio` boolean — Enable direct audio-video generation capability (default true for q3 model)
  - `audio_type` 'all' | 'speech_only' | 'sound_effect_only' — Audio type when audio is true: all (sound effects + vocals), speech_only, sound_effect_only. Ineffective for q3 model
  - `bgm` boolean — Add background music to generated video (ineffective for q3 model)
  - `callback_url` string — Callback URL for task status updates
  - `duration` integer — Video duration in seconds. viduq3-pro: 1-16, viduq2-pro-fast: 1-10, viduq2-pro/turbo: 1-8
  - `enhance` boolean
  - `images` string[] — Images for img2video (accepts 1 image as start frame)
  - `is_rec` boolean — Use recommended prompt (consumes additional 10 credits)
  - `meta_data` string — Metadata identification, JSON format string for custom metadata
  - `model` string — Model name: viduq3-pro, viduq2-pro-fast, viduq2-pro, viduq2-turbo, viduq1, viduq1-classic, vidu2.0
  - `movement_amplitude` 'auto' | 'small' | 'medium' | 'large' — Movement amplitude of objects in frame (ineffective for q2, q3 models)
  - `off_peak` boolean — Off peak mode (lower cost, tasks generated within 48 hours)
  - `payload` string — Transparent transmission parameters (max 1048576 characters)
  - `priority` integer
  - `prompt` string — Text prompt for video generation (max 2000 characters)
  - `resolution` string — Resolution: 360p, 540p, 720p, 1080p, 2K (availability depends on model and duration)
  - `seed` integer — Random seed (defaults to random if not specified)
  - `style` 'general' | 'anime'
  - `voice_id` string — Voice ID for audio (ineffective for q3 model)
  - `watermark` boolean — Add watermark to video (default false)
  - `wm_position` integer — Watermark position: 1 (top left), 2 (top right), 3 (bottom right, default), 4 (bottom left)
  - `wm_url` string — Watermark image URL (uses default watermark if not provided)

## Response `200`

OK

- ViduTaskReply
  - `aspect_ratio` string
  - `bgm` boolean — Whether background music was added
  - `created_at` string, date-time
  - `credits` integer, required
  - `duration` integer
  - `images` string[]
  - `model` string
  - `movement_amplitude` 'auto' | 'small' | 'medium' | 'large'
  - `off_peak` boolean — Off peak mode status
  - `payload` string — Transparent transmission parameters
  - `prompt` string
  - `resolution` string
  - `seed` integer
  - `state` 'created' | 'processing' | 'queueing' | 'success' | 'failed', required
  - `style` 'general' | 'anime'
  - `task_id` string, required
  - `watermark` boolean — Whether watermark was added

## Other responses

- `400` — Error 4xx/5xx
- `default` — Error 4xx/5xx

---

[API](https://skmtc.dev/ac/apis/comfy-api.md) · [All operations](https://skmtc.dev/ac/apis/comfy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ac/comfy-api/revisions/c1893dffe250/schema)