Skip to main content
POST
Text-to-video: create a video generation task from a text prompt
右側のプレイグラウンドでは直接デバッグできます。Bearer sk-your-api-keyAuthorization に入れ、model / input / parameters を入力して、リクエストを送信してください。送信に成功すると task_id が返されます。ポーリングとダウンロードについては下記を参照してください。
このページは wan2.7-t2v(テキストから動画生成)の作成エンドポイントです。必要なのはテキスト prompt だけで、メディアは不要です。画像を動かしたり被写体の特徴を保持したりしたい場合は、代わりに 画像から動画へ / 参照画像から動画へ を使用してください。非同期フローの全体、ステータステーブル、Python クライアントについては、Wan の概要 を参照してください。
  • 作成リクエストは /wan/api/v1/services/aigc/video-generation/video-synthesis に、ヘッダー X-DashScope-Async: enable を付けて送信してください。/v1/videos は使用しないでください。
  • duration整数 である必要があります(5"5" ではありません)。resolution大文字720P)で記述してください。

コード例

パラメータのクイックリファレンス

レスポンス形式

作成が成功すると、task_id が返されます(動画そのものではありません):

ステータス確認とダウンロード

task_id を取得したら、mp4 をダウンロードするために、次の 3 つの手順でステータスをポーリングしてください。
  • ポーリング GET /v1/tasks/{task_id}Authorization 付きで; クエリには X-DashScope-Async ヘッダーは不要です)を、5-10 秒ごと(3 秒未満は不可)に、statuscompleted になるまで実行します。
  • ステータス値: submitted(queued)/ in_progress(generating; progress が 30% 付近で止まっているのは正常です)/ completed(success)/ failederror を確認)。
  • ダウンロード: 応答から result_url を直接 GET し、Authorization ヘッダーなしで(OSS 署名付きの直接リンクです — Auth を送ると 403 が返ります);result_url は既定で 24 時間 で失効するため、すぐに保存してください。
上記は、「task_id をすでに持っている」場合の簡易な確認/ダウンロード手順です。タイムアウトのフォールバックを含む完全なポーリングループと Python クライアントについては、Wan 概要 · 非同期呼び出しフロー を参照してください。

承認

Authorization
string
header
必須

The API Key obtained from the APIYI console

ヘッダー

X-DashScope-Async
enum<string>
デフォルト:enable
必須

Async processing switch; must be set to enable, otherwise it returns current user api does not support synchronous calls

利用可能なオプション:
enable

ボディ

application/json
model
enum<string>
デフォルト:wan2.7-t2v
必須

Model ID; for text-to-video, fixed wan2.7-t2v (legacy version wan2.6-t2v)

利用可能なオプション:
wan2.7-t2v,
wan2.6-t2v
input
object
必須
parameters
object

レスポンス

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier; provide it to support when troubleshooting

:

"a23b81b0-0c05-9972-a6c9-ee757400afdb"