Open API

動画生成 API

LMU AI 動画生成 API の概要:Seedance と Wan の選び方に加え、認証・非同期タスク・課金・同時実行数の上限・エラーコードに関する共通ルールを説明します。

LMU AI は 2 種類の非同期動画生成 API を提供しており、いずれもベンダーのネイティブプロトコルを使用します。公式 SDK や curl コマンドのアドレスを LMU AI のアドレスに、キーを LMU AI の API キーに置き換えるだけで、リクエストボディはそのまま使えます。このページは概要です。下の表から API を選び、各プロバイダーのページを参照してください。両プロバイダーに共通するルール(認証、課金、同時実行数の上限、エラーコード)はこのページに記載しています。

ベース URL

https://api.lmuai.com
プロバイダータスク作成タスク照会ドキュメント
Seedance(Volcengine Ark)POST /api/v3/contents/generations/tasksGET /api/v3/contents/generations/tasks/{id}Seedance 動画生成 API
Wan(Alibaba DashScope)POST /api/v1/services/aigc/video-generation/video-synthesisGET /api/v1/tasks/{task_id}Wan 動画生成 API

グループで動画生成を有効にする必要があります

API キーのグループで「動画生成」が有効になっている必要があります。有効でない場合、呼び出しは 403 を返します。実際に呼び出せるモデルは API キーによって異なります。GET /v1/models で確認してください。

1. 2 つの API の選び方

Seedance(Volcengine Ark)Wan(Alibaba DashScope)
モデル例seedance-2.5wan3.0-video
課金出力トークン数に基づく「実際の秒数 × 解像度ランクごとの単価」に基づく
解像度の値480p / 720p / 1080p(小文字)480P / 720P / 1080P(大文字)、デフォルトは 1080P
タスクのステータスqueued → running → succeeded / failed / cancelledPENDING → RUNNING → SUCCEEDED / FAILED / CANCELED
動画 URL のフィールドcontent.video_urloutput.video_url
タスクのキャンセルキュー待ち(queued)のタスクはキャンセル可能キャンセル用エンドポイントなし。送信したタスクは必ず完了まで実行されます

モデル名は、グループで有効化されている名前と完全に一致している必要があります(大文字と小文字を区別)。2 つの API はフィールド名が似ていますが、大文字・小文字の使い分けやパスが異なるため、サンプルをコピーする際に混同しないよう注意してください。

2. 認証

すべてのリクエストのヘッダーで API キーを送信してください:

Authorization: Bearer YOUR_API_KEY

API キーをブラウザのフロントエンドコード、公開リポジトリ、URL のクエリ文字列、ログに含めないでください。API は自社のサーバーから呼び出してください。

3. 非同期タスクの流れ

  1. 作成:POST はタスク ID のみを返し、動画の完成を待ちません。
  2. ポーリング:最終状態(成功/失敗/キャンセル)になるまで、約 10 秒ごとにタスクを GET します。
  3. 参照画像:API 呼び出しでは、公開アクセス可能な画像 URL(JPG / PNG / WebP)を渡す必要があります。コンソールの「動画生成」ページではローカル画像のアップロードが可能です。
  4. ダウンロード:成功したら、レスポンスから動画リンクを取得します。アップストリームのリンクは 24 時間有効なので、早めにダウンロードしてください。プラットフォームは完成した各動画のコピーを保存しており、コンソールの「動画タスク」ページで再生・ダウンロードできます。

ポーリングを停止しても精算は行われます

送信後、プラットフォームはバックグラウンドでタスクを追跡し、照会を停止しても通常どおり精算します。失敗またはキャンセルされたタスクは課金されません。

作成からポーリングまでの完全なサンプルは、Seedance と Wan のページを参照してください。

4. 課金とウォーターマーク

  • タスク作成時に見積額が凍結されます。残高が不足している場合、リクエストは即座に拒否され(402)、動画は生成されません。
  • 成功時には実際の使用量に基づいて 1 回だけ精算され、凍結額の超過分は自動的に返却されます。失敗またはキャンセルされたタスクは全額返金され、課金されません。
  • Seedance は出力トークン数に基づいて課金され、Wan は「実際の秒数 × 解像度ランクごとの単価」に基づいて課金されます。
  • 完成した動画にはプラットフォームの「AI生成」ラベルが付与され、クライアント側でオフにすることはできません。

5. 同時実行数の上限

各ユーザーおよび各 API キーで同時に生成できるタスクは最大 5 件です。これを超えると、リクエストは Retry-After ヘッダー(約 60 秒)付きで 429 を返します。待機してから再試行してください。

6. エラーコード

HTTP意味対処方法
401API キーが無効、または無効化されているAPI キーを確認してください
402見積額を凍結するための残高またはクォータが不足しているチャージしてから再試行してください
403グループで動画生成が有効になっていない、またはグループでモデルが利用できない動画生成に対応した API キーを使用してください
404 model_not_foundモデルがまだ利用できない(モデル名のスペルミスでも発生します)GET /v1/models が返す正確な名前を使用してください
409タスクがすでに生成を開始しており、キャンセルできない(Seedance のキャンセル用エンドポイント)タスクの完了を待ってください
429実行中のタスク数が上限に達しているRetry-After に従って待機してから再試行してください

一般的なエラーについては、エラーコードを参照してください。

7. プロバイダーページ

  • Seedance 動画生成 API:タスクの作成・照会・一覧取得・キャンセル、パラメータ、先頭フレーム参照画像に関する注意事項、および完全なポーリングのサンプル。
  • Wan 動画生成 API:タスクの作成・照会、パラメータ、および完全なポーリングのサンプル。

最終更新:

このページの目次