Wan と HappyHorse シリーズ

Alibaba の動画生成モデルで、全 6 モデルです。OfoxAI の動画エンドポイント POST /v1/videos で呼び出します。タスクは非同期で実行され、タスクを作成するとタスク ID が返り、その ID で結果を照会します。

モデルの選び方

6 モデルとも、テキストから動画と画像から動画に対応し、同期した音声トラックを生成できます（generate_audio のデフォルトは true）。adaptive は入力画像の比率をそのまま使うことを表します。

上の表は Models API が返す video_attributes と一致しています。モデルの機能が変更された場合は API の返り値が優先されます。秒単位で課金され、実際の料金はタスク結果の usage.video_cost に従います。価格はモデルページ を参照してください。

呼び出し例

以下の例はタスク作成のリクエストのみを示しています。作成後にステータスを照会し、結果をダウンロードするまでの流れは Video API · クイックスタートを参照してください。

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "早朝の江南の水郷、小舟がゆっくりと石橋の下をくぐる",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "画面の人物が振り返り、遠くへ歩いていく",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.7",
    "prompt": "カメラワークはそのままに、水墨画アニメのスタイルに変える",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images と input_references は同時に渡せません。両方を渡すと 400 references_conflict が返ります。
• 音声トラックが不要な場合は "generate_audio": false を渡します。
• フィールド構造の詳しい説明は動画タスクを作成を参照してください。

ほかのシリーズとの違い

• キャンセル不可：タスクがアップストリームに送信された後は、DELETE /v1/videos/{id} が 400 cancel_not_supported を返し、タスクは生成を続けて課金されます。送信前にパラメータを確認してください。
• 動画の URL：実測では、タスク完了後に返るのは unsigned_urls（Alibaba Cloud OSS の一時アドレス）のみで、mirror_urls は含まれません。一時アドレスは 24 時間後に無効になる場合があるため、速やかにダウンロードして保存してください。
• より短い長さ：Wan は最短 2 秒、HappyHorse は最短 3 秒です。ほかのシリーズは最短 4 秒です。

ウォーターマークの除去

Alibaba 系モデル固有のパラメータは provider.options.dashscope で渡します。

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options は一致したプロバイダーにのみ渡され、ほかのプロバイダーは受け取りません。詳しい説明は動画のプロバイダールーティングを参照してください。

よくあるエラー

エラーコードの全体は Video API エラーコードを参照してください。

公式ドキュメント

• Alibaba Cloud Model Studio · モデルサービスのドキュメント 
• OfoxAI · 動画タスクを作成

よくある質問