メインコンテンツへスキップ

​
概要

WaveAPI は複数の動画生成モデルに対応しており、統一された非同期タスクインターフェース /v1/tasks で呼び出します。動画生成は通常時間がかかるため、ポーリングまたは Webhook コールバックで結果を取得してください。

​
リクエストエンドポイント

POST https://qingbo.dev/v1/tasks

​
共通リクエストパラメータ

パラメータタイプ必須説明
modelstringはいモデル名
actionstringいいえデフォルト "generate"
promptstringはい動画の説明テキスト
durationintegerいいえ動画の長さ（秒）
aspect_ratiostringいいえアスペクト比、例："16:9"
first_framestringいいえ先頭フレーム画像 URL（画像から動画生成）
last_framestringいいえ末尾フレーム画像 URL（first_frame と併用が必要）
video_urlstringいいえ参照動画 URL
video_urlsarrayいいえ複数の参照動画 URL
image_urlstringいいえ参照画像 URL
image_urlsarrayいいえ複数の参照画像 URL
generate_audiobooleanいいえ音声も同時に生成するかどうか
watermarkbooleanいいえ透かしを追加するかどうか
callback_urlstringいいえ完了後のコールバックアドレス
extraobjectいいえモデル固有のパススルーパラメータ

​
レスポンス形式

{
  "task_id": "task_xxx",
  "status": "completed",
  "result": {
    "videos": [
      {
        "url": "https://...",
        "expires_at": 1720000000
      }
    ]
  }
}

​
対応モデル

VEO3

Google 動画生成モデル

Sora2

OpenAI 動画生成モデル

Kling

Kuaishou Kling シリーズ

その他のモデル

Hailuo、Doubao、Vidu、Wan など

​
生成モード

ほとんどの動画モデルは以下のモードに対応しています：
モードパラメータ説明
テキストから動画promptテキスト説明から動画を生成
画像から動画prompt + first_frame または image_url画像に基づいて動画を生成
先頭末尾フレームfirst_frame + last_frame先頭と末尾の画面を指定して遷移動画を生成
全てのモデルが全モードに対応しているわけではありません。各モデルのドキュメントで具体的な対応状況をご確認ください。