画像生成タスクを作成

POST

/ent/v2/reference2image

• 公式ドキュメント: https://platform.vidu.cn/docs/image-generation
• 画像生成タスクを作成し、task_id またはタスク詳細を返す
• リクエストパラメータで生成動作を制御

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

テキストプロンプト
生成のためのテキスト説明。最大 2000 文字
注: viduq2 は文生図に対応。viduq2 で images をアップロードしない場合、このテキストから画像を生成

モデル名
指定可能: viduq2、viduq1
viduq2: 文生図、画像編集、参照生図
viduq1: 参照生図のみ

ランダムシード
未指定または 0 の場合はランダム値を使用
手動設定時はそのシードを使用

画像参照
viduq2: 0～7 枚
viduq1: 1～7 枚
モデルはこれらの画像の主題を参照して生成します。
注1: Base64 または画像 URL（アクセス可能であること）
注2: png、jpeg、jpg、webp
注3: 最小 128×128 ピクセル。アスペクト比は 1:4 または 4:1 未満
注4: 最大 50 MB
注5: HTTP POST body は最大 20 MB。適切な Content-Type を含めること。例:

data:image/png;base64,{base64_encode}

アスペクト比（モデルにより異なる）:
viduq1: デフォルト 16:9。16:9、9:16、1:1、3:4、4:3
viduq2: デフォルト 16:9。16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2

• auto: 最初の入力画像と同じ比率

解像度（モデルにより異なる）:
viduq1: デフォルト 1080p。1080p のみ
viduq2: デフォルト 1080p。1080p、2K、4K

パススルーパラメータ
処理は行わず、データ転送のみ
注: 最大 1048576 文字

コールバック URL（POST）。タスク作成時に設定。Vidu がステータス更新を送信。本文はタスク照会 API と同じ
コールバック status:

• processing: 処理中
• success: 完了（配信失敗時は最大 3 回再試行）
• failed: 失敗（配信失敗時は最大 3 回再試行）
  Vidu はコールバック署名認証を使用

Responses

成功

Content-Type

application/json

object