ドキュメント動画 API

動画

Unified Video API

MidSync の統一動画生成入口で、フロントエンドと API key 連携の両方で使います。

POST /unified-video/generate権限: 実際の backend API key scope 設定に依存します

向いている用途

顧客向け動画体験と API key 連携を作るチーム。

統一動画生成

送信前に見積もりを出したい

モデル metadata と規則で request body を組み立てたい

呼び出し例

bash

curl --request POST \
  --url https://api.midsync.dev/unified-video/generate \
  --header "Authorization: Bearer <your_api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedance-1.5-pro",
    "prompt": "夕暮れの海辺を映画的に映し、穏やかな波が打ち寄せる",
    "resolution": "720p",
    "aspectRatio": "16:9",
    "duration": 8,
    "generateAudio": true
  }'

概要使い方 Endpoints モデル seedance-1.5-pro のリクエスト項目ルール価格レスポンス統合メモ結果の受け取り：callbackUrl とポーリング

概要

このページは MidSync の統一動画生成フローを説明するもので、フロントエンドと API key 連携の両方に使えます。

GET /unified-video/models をフォーム定義に使い、POST /unified-video/quote で見積もり、POST /unified-video/generate で本送信します。

この API の使い方

Step 1

まず動画モデルを選びます。例: seedance-1.5-pro、kling-2.5-turbo、runway、grok-video。

Step 2

まず GET /unified-video/models を呼び、同じ request body を POST /unified-video/quote と POST /unified-video/generate に送ります。

Step 3

返却された taskId、providerTaskId、model、pointsCharged を保持し、callback または後続の確認フローで結果を扱います。

Endpoints

GET /unified-video/models が metadata、POST /unified-video/quote が見積もり、POST /unified-video/generate が本番タスク作成です。
モデルごとのパラメータ規則は下のモデルドキュメントを参照してください。
課金と利用状況は GET /v1/usage/logs と GET /v1/usage/summary で確認します。

モデル別サマリー

モデル

向いている用途

主な入力

価格ルール

seedance-1.5-pro

テキスト動画生成、画像動画生成

prompt、images、aspectRatio、resolution、duration

resolution、duration、generateAudio の組み合わせ

seedance-1.5-pro のリクエスト項目

必須

model と prompt。prompt の長さは 3..2500 です。

メディア入力

images は最大 2 件の画像 URL。0 件で text-to-video、1 から 2 件で image-to-video です。

出力制御

aspectRatio は 1:1、4:3、3:4、16:9、9:16、21:9、2:3、3:2。resolution は 480p、720p、1080p。duration は 4、8、12。

トグル

fixedLens、generateAudio、nsfwChecker は任意の boolean。projectId は任意の内部文脈です。

コールバック

callbackUrl は任意の URL。指定すると、動画完成時にサーバーが結果をこの URL に POST します。

入力ルール

seedance-1.5-pro では firstFrameUrl、lastFrameUrl、referenceImageUrls、referenceVideoUrls、referenceAudioUrls、returnLastFrame、webSearch を使いません。
seedance-1.5-pro の images.length は 2 を超えてはいけません。
seedance-2 と seedance-2-fast は現在一時停止中です。顧客向け UI には表示しないでください。

価格メモ

seedance-1.5-pro は resolution、duration、generateAudio による動的価格表です。
外部 API では、実際のタスク作成レスポンスに含まれる charged points を最終課金値として扱ってください。

レスポンス形式

json

{
  "success": true,
  "taskId": "generated-task-id",
  "providerTaskId": "provider-task-id",
  "model": "seedance-1.5-pro",
  "providerModel": "bytedance/seedance-1.5-pro",
  "pointsCharged": 25,
  "status": "submitted",
  "estimatedTime": "~2-3 min",
  "estimatedTimeSec": 140
}

タスク作成後は taskId、providerTaskId、model を保持してください。

統合メモ

外部 API ドキュメントの主入口として /unified-video/* を見せないでください。
主な生成入口は /unified-video/generate とし、モデル差分はモデル別ドキュメントで表現してください。
利用履歴と支出の可視化は usage logs と summary で行います。

結果の受け取り：callbackUrl とポーリング

generate リクエストに callbackUrl を含めると、動画完成時にサーバーが自動的にその URL へ結果を POST します。本番環境ではこの方法を推奨します。

または GET /unified-video/:taskId/status をポーリングして、status が completed か failed になるまで確認することもできます。ポーリングはデバッグや webhook が使えない場合に便利です。

すぐに試したいですか？

Settings で general API key を作成してから、ここに戻ってリクエスト例をコピーしてください。

API キーを開く