AGTCloud API Docs
ガイドAPIリファレンス連携とリソース更新とヘルプ
動画生成Wan

動画を作成

ネイティブ入力構造で Wan 3.0 動画タスクを作成します。

model/input/parameters で標準モデルのタスクを送信します。ネイティブ形式でもプラットフォーム API アドレスと API Key を使用し、Alibaba Cloud Workspace ID は不要です。非同期処理は自動で有効になるため、X-DashScope-Async は不要です。

POST/api/v1/services/aigc/video-generation/video-synthesis

認証

bearerAuth
認証Bearer <token>

プラットフォーム API Key を使用:Authorization: Bearer your-api-key。

指定位置: header

リクエストボディ

application/json

TypeScript 型定義

TypeScript で request body 型を使用します。

ネイティブ構造で送信します。非同期処理は自動で有効になり、X-DashScope-Async は不要です。

レスポンスボディ

application/json

application/json

application/json

素材と組み合わせのルール

プロンプトまたは空でない media が必要です。画像、動画、音声は配列内の同じ種類の順序で別々に数え、「图1」「视频1」「音频1」で参照できます。素材参照 ID は不要です。

素材形式と数量主な制限
開始・最終フレームfirst_frame、last_frame は各最大 1 枚最終フレームには開始フレームが必要。参照画像、動画、音声、ファイル、ウェブページとは併用不可
参照画像reference_image は最大 10 枚JPEG/JPG/PNG(アルファなし)/BMP/WEBP。各 20MB 以下、各辺 240~8000px、比率は最大 8:1
参照動画reference_video は最大 5 本MP4/MOV。各 1~15 秒、合計 15 秒以下。各 100MB 以下、各辺 240~4096px、16fps 以上、比率は最大 8:1
参照音声reference_audio は最大 5 本WAV/MP3。各 1~15 秒、合計 15 秒以下、各 15MB 以下
ファイルfile は最大 1 個100MB 以下。PDF、Word、PowerPoint、Keynote、Pages は 50 ページ以下。形式はフィールド表を参照
ウェブページlink は最大 1 個ログイン不要の公開 HTTP/HTTPS ページ。ファイルとは併用不可

開始・最終フレームの形式、容量、寸法は参照画像と同じです。画像は公開 URL または data:image/png;base64,... のような形式プレフィックス付き Base64 に対応し、他の素材は URL を使用します。通常素材はアクセス可能な OSS アドレスも使用でき、ページは HTTP/HTTPS のみです。ページ以外で拡張子がある場合は素材形式に合わせ、拡張子なしでも内容仕様を満たしてください。

参照画像・動画・音声は併用できます。ファイルまたはページもこれらと組み合わせられますが、file と link は排他的です。ファイル・ページでは prompt_extend を有効にしてください。編集と延長は参照動画とプロンプトで指定し、延長時は ratio: "adaptive" を使います。

時間は -1(自動)または 2~30 秒の整数です。参照動画がある場合、入力と出力動画の合計時間は 30 秒以内です。

作成結果と次の操作

送信後に output.task_id を保存し、ネイティブ照会 APIで状態と結果を取得します。request_id は追跡用で、タスク照会には使用しません。進捗確認のために同じタスクを再作成しないでください。

共通プラットフォームフィールドにはプラットフォーム形式の作成を使用します。二つの形式は混在させないでください。

よくあるエラー

HTTP 400 ではエラーに従って JSON、モデル名、input/parameters、素材の組み合わせを確認します。エラーは code/message/data または入れ子の error で返る場合があります。問い合わせ時はエラーとリクエスト ID を伝え、API Key は共有しないでください。

Alibaba Cloud Wan 3.0 動画生成公式 API ドキュメントモデルのネイティブパラメーター、素材仕様、組み合わせルールを確認できます。