画像から動画タスクを作成
- 公式ドキュメント: https://platform.vidu.cn/docs/image-to-video
- 画像から動画タスクを作成し、task_id またはタスク詳細を返す
- リクエストパラメータで生成動作を制御
Authorizations
Request Body
テキストプロンプト
動画生成のためのテキスト説明。
注: 2000 文字を超えてはならない
モデル名
指定可能: viduq2、viduq1、viduq3-turbo、viduq3-pro
- viduq3-turbo: viduq3-pro より生成が高速
- viduq3-pro: 高品質な音声・動画を効率的に生成。より鮮やかで立体的
- viduq2: 最新モデル
- viduq1: 鮮明な映像、スムーズな転換、安定したカメラワーク
動画の長さ。デフォルトはモデルにより異なる:
- viduq3-pro、viduq3-turbo: デフォルト 5 秒、範囲 1–16
- viduq2: デフォルト 5 秒、範囲 1–10
- viduq1: デフォルト 5 秒、指定可能 5 のみ
ランダムシード
未指定または 0 の場合はランダム値を使用
手動設定時はそのシードを使用
解像度。デフォルトはモデルと動画の長さにより異なる:
- 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 モデル使用時はこのパラメータは無効
パススルーパラメータ
処理は行わず、データ転送のみ
注: 最大 1048576 文字
オフピークモード。デフォルト false。指定可能:
- true: オフピークで動画を生成
- false: 即時に動画を生成
注1: オフピークモードは消費クレジットが少ない。料金プランを参照
注2: オフピークで送信したタスクは 48 時間以内に生成。未完了は自動キャンセルされクレジット返還
注3: オフピークタスクは手動でキャンセル可能
ウォーターマークを追加するかどうか
- 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 はコールバック署名アルゴリズムで認証します。詳細はコールバック署名ドキュメントを参照
先頭フレーム画像
モデルはこのパラメータの画像を先頭フレームとして動画を生成します。
注1: 画像の Base64 または画像 URL（アクセス可能であること）に対応
注2: 画像は 1 枚のみ
注3: 形式: png、jpeg、jpg、webp
注4: 画像のアスペクト比は 1:4 または 4:1 未満であること
注5: 画像サイズは 50 MB 以下
注6: HTTP POST の body は 20 MB 以下。適切な Content-Type を含めること。例:
data:image/png;base64,{base64_encode}
音声・動画の直接出力を使用するか。デフォルト false。指定可能:
- false: 音声・動画の直接出力なし（無音動画）
- true: セリフと背景音付きの動画を出力
注1: このパラメータが true のときのみ voice_id が有効
注2: model が q3-pro または q3-turbo のとき、デフォルトは true
注3: このパラメータが true のとき、オフピークモードは使用不可
音色 ID
動画内の声の音色を決定。空の場合はシステムが推奨。一覧: https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
推奨プロンプトを使用するか
- true: システムがプロンプトを推奨（数=1）し、その内容で動画を生成
- false: 入力 prompt に基づいて生成
注: 推奨プロンプトを有効にすると、タスクごとに 10 クレジット追加消費
Responses
成功