ドキュメント APIリファレンス SDKリファレンスエージェント利用 AIスキル

動画

動画生成リクエストを送信

非同期の動画生成ジョブを送信します。即座に 202 とジョブ id(vjob_ プレフィックス)を返します。GET /api/v1/videos/{id} で status が completed になるまでポーリングし、unsigned_urls からダウンロードしてください。課金:送信時に duration × resolution で予約し、完了時に実際の配信秒数で精算されます(ポーリング応答の usage.cost)。

POST/api/v1/videos

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

model必須

string

動画生成モデル ID(プロバイダー修飾形式)。

Example: "alibaba/wan2.7-t2v"

prompt必須

string

生成する動画を説明するテキストプロンプト。

duration

integer

動画の長さ(秒)。デフォルトは 2。モデルごとに上下限があります——例えば参照画像からの動画生成(r2v)は 2–10 秒。範囲外の値は課金前に 400 を返します。

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

出力画質ティア。デフォルトは "720p"。対応ティアはモデルごとに異なります。未対応のティアは課金前に 400 を返し、エラーメッセージに対応ティアの一覧が含まれます。

480p720p1080p

Example: "720p"

aspect_ratio

string

アスペクト比。一般的な値:"16:9"、"9:16"、"1:1"、"4:3"、"3:4"。利用可能なセットはモデルに依存します("21:9" などのワイド比に対応するモデルもあります)。未対応の組み合わせは課金前に 400 を返します。入力フレームを取るモードではフレームから比率が決まり、このフィールドは無視されます。

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

最初/最後のキーフレーム画像(image-to-video、keyframe-to-video)。URL 文字列、またはオブジェクト { type: "image", image_url: { url }, frame_type: "first" | "last" } を受け付けます。

input_references

object[] | string[]

参照アセット(reference-to-video):参照アイテムで生成をガイドします。オブジェクト形式 { type: "image", image_url: { url } } を推奨(URL 文字列も受け付け、画像参照として扱われます)。画像参照が最も広く対応。音声/動画の参照オブジェクトはそのまま転送され、対応モデルでのみ有効です——それ以外のモデルは画像参照のみ使用します。r2v モードを持つモデルのみこのフィールドに対応。

input_video

string | object

ソース動画(動画編集モデル専用、BazaarLink 拡張フィールド)。URL 文字列、{ video_url: { url } }、または { url } を受け付けます。動画編集以外のモデルでは無視されます。編集はソース秒数+出力秒数で課金されます。

generate_audio

boolean

音声も生成するかどうか。音声対応モデルのみ有効。音声ありの秒数はより高い秒単価で課金されます。

watermark

boolean

出力にウォーターマークを付けるかどうか。デフォルトは false——明示的に true を渡さない限り、BazaarLink はアップストリームのデフォルトウォーターマークを無効化します。

seed

number

サンプリングシード。再現性の保証はモデルによって異なります。

callback_url

string

ジョブの終了状態で呼び出される webhook URL——ポーリング不要になります。HTTPS のみ対応し、クレジットが予約される前に SSRF チェック(プライベート/内部アドレスは拒否)が行われます。終了状態の確定を勝ち取ったリクエストからのみ、正確に1回発火します。配信は失敗時に再試行されます(2回、2秒/8秒のバックオフ)。再試行を使い切っても課金やジョブの実際のステータスには影響しません。v1 に署名はありません——コールバックはヒントとして扱い、実行前に API キーで GET /v1/videos/{id} を呼び出してステータスと金額を確認してください。⚠️ webhook ペイロード内の unsigned_urls は絶対 URL です。ポーリングエンドポイントが返す相対パスとは異なります。

https:// only, ≤2048 chars

詳細ガイド →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

レスポンス例

ジョブ受理(非同期)。返された polling_url(GET /api/v1/videos/{id})でステータスをポーリングしてください。間隔は 5 秒以上を推奨。

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}