テキストから動画タスクを作成
- 公式ドキュメント: https://platform.vidu.cn/docs/text-to-video
- テキストから動画タスクを作成し、task_id を返します
- model、prompt などのパラメータで生成を制御します
Authorizations
Request Body
テキストプロンプト
動画生成のためのテキスト説明。
注: 2000 文字を超えてはいけません
モデル名
指定可能な値: viduq3-turbo、viduq3-pro、viduq2、viduq1
- viduq3-turbo: viduq3-pro より生成速度が速い
- viduq3-pro: 高品質な音声・動画を効率的に生成し、より生き生きとした立体的な映像
- viduq2: 最新モデル
- viduq1: 画面が鮮明で、トランジションが滑らか、カメラワークが安定
スタイル
デフォルトは general。指定可能: general、anime
general: 汎用スタイル。プロンプトでスタイルを制御可能
anime: アニメスタイル。アニメ表現に強く、異なるアニメ系プロンプトで制御可能
注: q2 モデル使用時はこのパラメータは無効
動画の長さ。デフォルトはモデルにより異なります:
- viduq3-pro、viduq3-turbo: デフォルト 5 秒、選択可能 1–16
- viduq2: デフォルト 5 秒、選択可能 1–10
- viduq1: デフォルト 5 秒、選択可能 5 のみ
ランダムシード
未指定または 0 の場合はランダム値を使用
手動設定時は指定したシードを使用
アスペクト比
デフォルト 16:9。指定可能: 16:9、9:16、3:4、4:3、1:1
注: 3:4、4:3 は q2 モデルのみ対応
解像度。デフォルトはモデルと動画の長さにより異なります:
- viduq3-pro、viduq3-turbo (1–16 秒): デフォルト 720p、指定可能 540p、720p、1080p
- viduq2 (1–10 秒): デフォルト 720p、指定可能 540p、720p、1080p
- viduq1 (5 秒): デフォルト 1080p、指定可能 1080p
動きの振幅
デフォルト auto。指定可能: auto、small、medium、large
注: q2 モデル使用時はこのパラメータは無効
生成動画に BGM を追加するかどうか。
デフォルト false。指定可能 true、false
true の場合、プリセット BGM ライブラリから適切な音楽を自動選択して追加。false または未指定では BGM なし。
- BGM の長さに制限はなく、動画の長さに自動適合
パススルーパラメータ
処理は行わず、データ転送のみ
注: 最大 1048576 文字
ウォーターマークを追加するかどうか
- true: ウォーターマークを追加
- false: 追加しない
注1: 現在のウォーターマーク内容は固定（AI 生成）。デフォルトはオフ
注2: watermarked_url パラメータでウォーターマーク付き動画を取得可能。詳細はタスク照会 API を参照
ウォーターマークの位置（画像上）:
1: 左上
2: 右上
3: 右下
4: 左下
デフォルト: 3
ウォーターマークの内容（画像 URL）
未指定時はデフォルトのウォーターマーク「AI により生成されたコンテンツ」
メタデータ識別子（JSON 文字列）、パススルー。カスタム形式または例の形式を使用可能。例:
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
空の場合、デフォルトで Vidu 生成のメタデータ識別子を使用
コールバック URL。タスク作成時に callback_url を設定してください。POST で、動画生成タスクの状態が変わると Vidu がこの URL に最新状態を送信します。リクエスト本文はタスク照会 API のレスポンスと同じ構造です。
コールバックの status 値:
- processing: 処理中
- success: 完了（送信失敗時は最大 3 回再試行）
- failed: 失敗（送信失敗時は最大 3 回再試行）
Vidu はコールバック署名アルゴリズムで認証します。詳細はコールバック署名ドキュメントを参照
Responses
成功