Vidu Image Q2 · API リファレンス
Vidu Image Q2 でテキストや参照画像から画像を生成し、タスクの状態を確認して結果をダウンロードします。
POST /v1/wand/vidu-image/generation でタスクを作成し、GET /v1/wand/vidu-image/tasks/{task_id} で検索します。 APIMaster API キーを Authorization: Bearer ヘッダーに両方のリクエストで送信します。 POST リクエストの本文は JSON 形式です。
| フィールド | 型 | 説明 |
|---|---|---|
model |
string | 必須。 vidu-image-q2 を使用します。 |
prompt |
string | 必須。 最大 2,000 文字です。 テキストのみから画像を生成する場合は参照画像を省略します (text-to-image)。 |
images |
string[] | オプション。PNG、JPEG/JPG、WebP 形式の公開 URL またはデータ URI を最大 7 件指定できます。各画像は 128 × 128 ピクセル以上で、縦横比は 1:4~4:1、ファイルサイズは最大 50 MB です。リクエスト本文全体は最大 20 MB です。 |
aspect_ratio |
string | 16:9 がデフォルトです。 オプションは 16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2、autoです。 autoの設定は、最初の参照画像に従います。 |
resolution |
string | 1080p がデフォルトです。 2K と 4K をサポートしています。 大文字と小文字は区別されます。 |
seed |
integer | ランダムなシードを使うには、この項目を省略するか 0 を指定します。 |
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'
返された task_id と同じアカウントを使い、3–5 秒ごとに状態を確認します。 可能な状態は created、queueing、processing、success、およびfailedです。 creations[].urlの下のファイルを 12時間以内にダウンロードします。 request_id を使用して、不適切な画像、コンテンツレビュー、不十分なクレジット、レート制限、または欠けているタスクなどの失敗を追跡します。
ステータスを確認しても、新しい生成や追加の請求は発生しません。 callback_url はサポートされていません。 失われたサブスクリプションを回復するには、8–128 見える ASCII キャラクターの安定した Idempotency-Key を送信し、元のリクエストを復旧する手順 に従ってください。 同じキーに同じパラメーターを指定すると、HTTP 202 と復旧用の受領情報が返ります。 同じキーに異なるパラメーターを指定すると HTTP 409 が返ります。
tokenhub_usage.total_tokens は、解像度と使用された参照数に依存する請求可能な使用を報告します。 見る The Vidu Image Q2 モデルカード 現時点について APIMaster 価格
