{ "zh": "

\n \n\n \n

\n \n

\n\n

\n \n \n \n \n Wan2.7 Text-to-Video API\n

\n\n

\n 用提示词生成
电影级多镜头视频\n

\n 万相 2.7 文生视频模型基于自然语言提示词生成流畅视频，支持多镜头叙事、自动配音、自定义音频、反向提示词与 720P / 1080P 输出。\n

\n\n

\n \n \n

\n\n

2–15 秒

视频时长

1080P

最高档位

宽高比

\n\n

Prompt Timeline

15s Multi-shot Story

\n \n

\n\n

Shot 01

雨夜街头 · 全景

Shot 02

人物入场 · 中景

Shot 03

表情线索 · 特写

\n\n

Async Task

\n CREATE\n RUNNING\n VIDEO URL\n

\n\n \n

核心视频生成能力

面向短视频创作、广告片段、剧情分镜和产品展示工作流优化。

\n\n

\n \n

多镜头叙事

直接通过 prompt 控制单镜头或多镜头结构，也可以使用时间戳描述每个镜头的景别、动作和叙事节奏。

\n\n

\n \n

自动配音与音频驱动

不传入音频时可根据视频内容自动生成背景音乐或音效；也支持传入 mp3 / wav 音频 URL 作为自定义音频输入。

\n\n

\n \n

720P / 1080P 输出

支持 16:9、9:16、1:1、4:3、3:4 等常用画幅，覆盖横版广告、竖屏短视频和社媒方形内容。

\n\n

\n \n

可控时长

duration 支持 2 到 15 秒整数配置，适合快速生成可预览、可剪辑、可投放的短视频片段。

\n\n

\n \n

Prompt 智能改写

prompt_extend 默认开启，可对较短提示词进行智能扩写，提升场景细节、镜头语言和生成稳定性。

\n\n

\n \n

反向提示词与 Seed

negative_prompt 可限制不想出现的元素；seed 可用于提升生成结果的可复现性，便于批量测试和版本对比。

\n\n \n

Async Video Pipeline

创建任务、轮询结果、保存视频

文生视频任务通常需要数分钟，HTTP 接口采用异步调用。推荐工作流是先创建生成任务并保存 task_id，再按合理间隔轮询任务状态，成功后立刻下载并转存返回的视频链接。

\n\n

Create Task

提交 prompt、resolution、ratio、duration 等参数。

Poll Status

使用 task_id 查询 PENDING、RUNNING、SUCCEEDED、FAILED 等状态。

Download Video

成功后获取 video_url；链接有效期有限，建议立即转存至永久存储。

\n\n \n

关键 API 参数

以下为 README 中建议展示的核心参数说明，适合用户在接入前快速理解模型能力边界。

\n\n

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

参数	类型	必填	说明
model	string	是	推荐使用 wan2.7-t2v-2026-04-25 或通用版本 wan2.7-t2v。
input.prompt	string	是	描述视频中希望包含的元素、动作、镜头与视觉风格，支持中英文，最长 5000 字符。
input.negative_prompt	string	否	描述不希望出现的内容，最长 500 字符，用于限制画面元素。
input.audio_url	string	否	公网或临时音频 URL，支持 mp3 / wav，时长 2–30 秒，文件不超过 15MB。
parameters.resolution	string	否	视频分辨率档位，支持 720P、1080P，默认 1080P；该参数会影响费用。
parameters.ratio	string	否	输出画幅，支持 16:9、9:16、1:1、4:3、3:4，默认 16:9。
parameters.duration	integer	否	生成视频时长，单位秒，取值 2–15，默认 5；按秒计费。
parameters.prompt_extend	boolean	否	是否开启 prompt 智能改写，默认 true；适合短 prompt 提升效果。
parameters.watermark	boolean	否	是否在右下角添加“AI 生成”水印，默认 false。
parameters.seed	integer	否	随机数种子，范围 0–2147483647；固定 seed 可提升结果可复现性。

\n\n \n

画幅与分辨率

同一 resolution 档位下，不同 ratio 会映射到不同输出像素，方便适配横版视频、竖屏短视频、方形社媒内容和传统画幅。

720P / 16:9

1280×720

1080P / 16:9

1920×1080

720P / 9:16

720×1280

1080P / 9:16

1080×1920

\n\n

计费提示

文生视频按成功生成的视频秒数计费，失败不计费也不占用免费额度。resolution 与 duration 会直接影响最终费用，建议在产品侧提供清晰的成本预估。

中国内地 / 北京

wan2.7-t2v / 快照版本

720P：0.6 元/秒

1080P：1 元/秒

国际 / 新加坡

wan2.7-t2v / 快照版本

720P：0.733924 元/秒

1080P：1.100886 元/秒

价格可能随官方调整变化，请以上线时控制台和官方计费页面为准。

\n\n \n

\n \n \n \n HTTP Request Example\n

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \\\n  -H 'X-DashScope-Async: enable' \\\n  -H \"Authorization: Bearer $DASHSCOPE_API_KEY\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"model\": \"wan2.7-t2v-2026-04-25\",\n    \"input\": {\n      \"prompt\": \"生成多镜头视频。第 1 个镜头[0-3 秒] 全景：雨夜城市街头，霓虹灯闪烁。第 2 个镜头[3-6 秒] 中景：主角走入建筑。第 3 个镜头[6-10 秒] 特写：主角发现关键线索。\",\n      \"negative_prompt\": \"低质量、模糊、变形\"\n    },\n    \"parameters\": {\n      \"resolution\": \"1080P\",\n      \"ratio\": \"16:9\",\n      \"duration\": 10,\n      \"prompt_extend\": true,\n      \"watermark\": false,\n      \"seed\": 12345\n    }\n  }'

\n\n \n

常见问题解答

Wan2.7 文生视频适合什么场景？

\n \n

适合剧情分镜、短视频广告、产品演示、社媒内容、动画片段和需要通过文字快速生成视频概念稿的创意工作流。

\n\n

如何控制单镜头或多镜头？

\n \n

在 prompt 中明确写出“生成单镜头视频”或“生成多镜头视频”。多镜头场景建议加入时间戳，例如“第 1 个镜头[0-3 秒] 全景……”，以获得更清晰的叙事控制。

\n\n

自定义音频有什么限制？

\n \n

audio_url 支持 mp3 和 wav，音频时长 2–30 秒，文件不超过 15MB。若音频超过视频时长会被截断，短于视频时长的部分会输出无声画面。

\n\n

返回的视频链接需要保存吗？

\n \n

需要。任务成功后返回的 video_url 有效期有限，建议在获取结果后立即下载或转存到 OSS、S3 等永久存储服务。

\n\n \n

", "ja": "

\n \n\n \n

\n \n

\n\n

\n \n \n \n \n Wan2.7 Text-to-Video API\n

\n\n

\n プロンプトから
映画品質のマルチショット動画を生成\n

\n Wanxiang 2.7 Text-to-Video は、自然言語プロンプトから滑らかな動画を生成するモデルです。マルチショットのストーリーテリング、自動音声生成、カスタム音声、ネガティブプロンプト、720P / 1080P 出力に対応します。\n

\n\n

\n \n \n

\n\n

2–15 秒

動画の長さ

1080P

最高解像度

アスペクト比

\n\n

Prompt Timeline

15秒のマルチショットストーリー

\n \n

\n\n

Shot 01

雨の夜の街角 · ロングショット

Shot 02

人物の登場 · ミディアムショット

Shot 03

表情の手がかり · クローズアップ

\n\n

Async Task

\n CREATE\n RUNNING\n VIDEO URL\n

\n\n \n

主要な動画生成機能

ショート動画制作、広告素材、ストーリーボード、商品紹介ワークフローに最適化されています。

\n\n

\n \n

マルチショット構成

prompt で単一ショットまたは複数ショットの構成を直接指定できます。タイムスタンプを使って、各ショットの画角、動き、物語のテンポも記述できます。

\n\n

\n \n

自動音声生成と音声駆動

音声を渡さない場合は、動画内容に応じて BGM や効果音を自動生成できます。mp3 / wav の音声 URL を渡して、カスタム音声入力として使うこともできます。

\n\n

\n \n

720P / 1080P 出力

16:9、9:16、1:1、4:3、3:4 などの一般的な画幅に対応し、横型広告、縦型ショート動画、SNS 用スクエアコンテンツをカバーします。

\n\n

\n \n

制御可能な動画長

duration は 2〜15 秒の整数で指定できます。プレビュー、編集、配信に使いやすい短い動画クリップを素早く生成できます。

\n\n

\n \n

Prompt の自動拡張

prompt_extend はデフォルトで有効です。短いプロンプトを自動的に拡張し、シーンのディテール、カメラ表現、生成の安定性を高めます。

\n\n

\n \n

ネガティブプロンプトと Seed

negative_prompt で出したくない要素を制限できます。seed は生成結果の再現性を高め、バッチテストやバージョン比較に役立ちます。

\n\n \n

Async Video Pipeline

タスクを作成し、結果をポーリングし、動画を保存

Text-to-Video タスクは通常数分かかるため、HTTP インターフェースは非同期呼び出しを使用します。推奨フローは、生成タスクを作成して task_id を保存し、適切な間隔でステータスをポーリングし、成功後すぐに返された動画リンクをダウンロードして保存することです。

\n\n

Create Task

prompt、resolution、ratio、duration などのパラメータを送信します。

Poll Status

task_id を使って PENDING、RUNNING、SUCCEEDED、FAILED などの状態を確認します。

Download Video

成功後に video_url を取得します。リンクの有効期間は限られるため、すぐに永続ストレージへ保存することを推奨します。

\n\n \n

主要 API パラメータ

以下は README で表示することを推奨する主要パラメータです。導入前にモデルの能力範囲を素早く理解できます。

\n\n

パラメータ	型	必須	説明
model	string	はい	推奨モデルは wan2.7-t2v-2026-04-25、または汎用版 wan2.7-t2v です。
input.prompt	string	はい	動画に含めたい要素、動き、カメラワーク、ビジュアルスタイルを記述します。中国語と英語に対応し、最大 5000 文字です。
input.negative_prompt	string	いいえ	出力に含めたくない内容を記述します。最大 500 文字で、画面要素の制限に使用します。
input.audio_url	string	いいえ	公開または一時的にアクセス可能な音声 URL。mp3 / wav に対応し、長さは 2〜30 秒、ファイルサイズは 15MB 以下です。
parameters.resolution	string	いいえ	動画の解像度グレード。720P、1080P に対応し、デフォルトは 1080P です。このパラメータは料金に影響します。
parameters.ratio	string	いいえ	出力画幅。16:9、9:16、1:1、4:3、3:4 に対応し、デフォルトは 16:9 です。
parameters.duration	integer	いいえ	生成する動画の長さ。単位は秒で、値は 2〜15、デフォルトは 5 です。秒単位で課金されます。
parameters.prompt_extend	boolean	いいえ	prompt の自動拡張を有効にするかどうか。デフォルトは true で、短い prompt の品質向上に適しています。
parameters.watermark	boolean	いいえ	右下に「AI 生成」ウォーターマークを追加するかどうか。デフォルトは false です。
parameters.seed	integer	いいえ	乱数シード。範囲は 0〜2147483647 です。固定 seed により結果の再現性を高められます。

\n\n \n

画幅と解像度

同じ resolution グレードでも、ratio によって出力ピクセルが変わります。横型動画、縦型ショート動画、正方形 SNS コンテンツ、従来型の画幅に対応しやすくなります。

720P / 16:9

1280×720

1080P / 16:9

1920×1080

720P / 9:16

720×1280

1080P / 9:16

1080×1920

\n\n

料金メモ

Text-to-Video は、正常に生成された動画の秒数に基づいて課金されます。失敗したタスクは課金されず、無料枠も消費しません。resolution と duration は最終コストに直接影響するため、プロダクト側で明確なコスト見積もりを表示することを推奨します。

中国本土 / 北京

wan2.7-t2v / snapshot version

720P：0.6 元/秒

1080P：1 元/秒

国際 / シンガポール

wan2.7-t2v / snapshot version

720P：0.733924 元/秒

1080P：1.100886 元/秒

価格は公式側の更新により変わる可能性があります。リリース時点のコンソールと公式料金ページを基準にしてください。

\n\n \n

\n \n \n \n HTTP Request Example\n

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \\\n  -H 'X-DashScope-Async: enable' \\\n  -H \"Authorization: Bearer $DASHSCOPE_API_KEY\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"model\": \"wan2.7-t2v-2026-04-25\",\n    \"input\": {\n      \"prompt\": \"マルチショット動画を生成。第1ショット[0-3秒] ロングショット：雨の夜の都市の通り、ネオンが点滅している。第2ショット[3-6秒] ミディアムショット：主人公が建物に入る。第3ショット[6-10秒] クローズアップ：主人公が重要な手がかりを見つける。\",\n      \"negative_prompt\": \"低品質、ぼやけ、変形\"\n    },\n    \"parameters\": {\n      \"resolution\": \"1080P\",\n      \"ratio\": \"16:9\",\n      \"duration\": 10,\n      \"prompt_extend\": true,\n      \"watermark\": false,\n      \"seed\": 12345\n    }\n  }'

\n\n \n

よくある質問

Wan2.7 Text-to-Video はどんな用途に向いていますか？

\n \n

ストーリーボード、ショート動画広告、商品デモ、SNS コンテンツ、アニメーション素材、文字から素早く動画コンセプトを作成したいクリエイティブワークフローに向いています。

\n\n

単一ショットやマルチショットはどう制御しますか？

\n \n

prompt に「単一ショット動画を生成」または「マルチショット動画を生成」と明記します。マルチショットでは、「第1ショット[0-3秒] ロングショット……」のようにタイムスタンプを入れると、より明確に物語を制御できます。

\n\n

カスタム音声にはどんな制限がありますか？

\n \n

audio_url は mp3 と wav に対応し、音声の長さは 2〜30 秒、ファイルサイズは 15MB 以下です。音声が動画より長い場合は切り詰められ、短い場合は残りの部分が無音になります。

\n\n

返された動画リンクは保存する必要がありますか？

\n \n

はい。タスク成功後に返される video_url の有効期間は限られています。結果を取得したら、すぐにダウンロードするか、OSS、S3 などの永続ストレージへ保存してください。

\n\n \n

", "en": "

\n \n\n \n

\n \n

\n\n

\n \n \n \n \n Wan2.7 Text-to-Video API\n

\n\n

\n Generate cinematic
multi-shot videos from prompts\n

\n Wanxiang 2.7 Text-to-Video generates smooth videos from natural-language prompts, supporting multi-shot storytelling, automatic audio, custom audio input, negative prompts, and 720P / 1080P output.\n

\n\n

\n \n \n

\n\n

2–15 sec

Video Duration

1080P

Max Tier

Aspect Ratios

\n\n

Prompt Timeline

15s Multi-shot Story

\n \n

\n\n

Shot 01

Rainy street · Wide shot

Shot 02

Character entrance · Medium shot

Shot 03

Expression clue · Close-up

\n\n

Async Task

\n CREATE\n RUNNING\n VIDEO URL\n

\n\n \n

Core Video Generation Capabilities

Optimized for short-form video creation, ad clips, storyboards, and product showcase workflows.

\n\n

\n \n

Multi-shot storytelling

Control single-shot or multi-shot structures directly through the prompt. You can also use timestamps to describe each shot’s framing, action, and narrative pacing.

\n\n

\n \n

Automatic audio and audio-driven input

When no audio is provided, the model can automatically generate background music or sound effects based on the video content. It also supports mp3 / wav audio URLs as custom audio input.

\n\n

\n \n

720P / 1080P output

Supports common aspect ratios including 16:9, 9:16, 1:1, 4:3, and 3:4, covering horizontal ads, vertical short videos, and square social content.

\n\n

\n \n

Controllable duration

The duration parameter supports integer values from 2 to 15 seconds, ideal for creating short clips that are easy to preview, edit, and publish.

\n\n

\n \n

Prompt enhancement

prompt_extend is enabled by default. It intelligently expands shorter prompts to improve scene details, camera language, and generation stability.

\n\n

\n \n

Negative prompt and Seed

negative_prompt helps restrict unwanted elements. seed improves reproducibility, making batch testing and version comparison easier.

\n\n \n

Async Video Pipeline

Create tasks, poll results, and save videos

Text-to-video tasks usually take several minutes, so the HTTP API uses asynchronous calls. The recommended workflow is to create a generation task, save the task_id, poll the task status at reasonable intervals, and immediately download or transfer the returned video link after success.

\n\n

Create Task

Submit parameters such as prompt, resolution, ratio, and duration.

Poll Status

Use task_id to query statuses such as PENDING, RUNNING, SUCCEEDED, and FAILED.

Download Video

After success, retrieve video_url. The link is valid for a limited time, so transfer it to permanent storage immediately.

\n\n \n

Key API Parameters

The following are the recommended core parameters to show in the README, helping users quickly understand the model’s capability boundaries before integration.

\n\n

Parameter	Type	Required	Description
model	string	Yes	Recommended model: wan2.7-t2v-2026-04-25, or the general version wan2.7-t2v.
input.prompt	string	Yes	Describe the elements, actions, camera shots, and visual style you want in the video. Supports Chinese and English, up to 5000 characters.
input.negative_prompt	string	No	Describe content that should not appear. Up to 500 characters, used to restrict visual elements.
input.audio_url	string	No	A public or temporary audio URL. Supports mp3 / wav, 2–30 seconds long, with a file size no larger than 15MB.
parameters.resolution	string	No	Video resolution tier. Supports 720P and 1080P, defaults to 1080P. This parameter affects cost.
parameters.ratio	string	No	Output aspect ratio. Supports 16:9, 9:16, 1:1, 4:3, and 3:4, defaulting to 16:9.
parameters.duration	integer	No	Generated video duration in seconds. Valid range is 2–15, default is 5. Billing is calculated per second.
parameters.prompt_extend	boolean	No	Whether to enable intelligent prompt enhancement. Defaults to true and is useful for improving short prompts.
parameters.watermark	boolean	No	Whether to add an “AI-generated” watermark in the lower-right corner. Defaults to false.
parameters.seed	integer	No	Random seed, ranging from 0 to 2147483647. Fixing the seed can improve result reproducibility.

\n\n \n

Aspect Ratios and Resolution

Within the same resolution tier, different ratios map to different output pixel sizes, making it easier to support horizontal videos, vertical shorts, square social content, and traditional aspect ratios.

720P / 16:9

1280×720

1080P / 16:9

1920×1080

720P / 9:16

720×1280

1080P / 9:16

1080×1920

\n\n

Pricing Notes

Text-to-video is billed by the number of seconds in successfully generated videos. Failed tasks are not billed and do not consume free quota. resolution and duration directly affect the final cost, so it is recommended to show a clear cost estimate in your product.

Mainland China / Beijing

wan2.7-t2v / snapshot version

720P：0.6 CNY/sec

1080P：1 CNY/sec

International / Singapore

wan2.7-t2v / snapshot version

720P：0.733924 CNY/sec

1080P：1.100886 CNY/sec

Prices may change according to official updates. Please refer to the console and official pricing page at launch time.

\n\n \n

\n \n \n \n HTTP Request Example\n

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \\\n  -H 'X-DashScope-Async: enable' \\\n  -H \"Authorization: Bearer $DASHSCOPE_API_KEY\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"model\": \"wan2.7-t2v-2026-04-25\",\n    \"input\": {\n      \"prompt\": \"Generate a multi-shot video. Shot 1 [0-3s] wide shot: a rainy city street at night with flickering neon lights. Shot 2 [3-6s] medium shot: the protagonist enters a building. Shot 3 [6-10s] close-up: the protagonist discovers a key clue.\",\n      \"negative_prompt\": \"low quality, blurry, deformed\"\n    },\n    \"parameters\": {\n      \"resolution\": \"1080P\",\n      \"ratio\": \"16:9\",\n      \"duration\": 10,\n      \"prompt_extend\": true,\n      \"watermark\": false,\n      \"seed\": 12345\n    }\n  }'

\n\n \n

Frequently Asked Questions

What scenarios is Wan2.7 Text-to-Video suitable for?

\n \n

It is suitable for storyboards, short-form video ads, product demos, social media content, animation clips, and creative workflows that need to quickly generate video concept drafts from text.

\n\n

How do I control single-shot or multi-shot videos?

\n \n

Clearly write “generate a single-shot video” or “generate a multi-shot video” in the prompt. For multi-shot scenes, add timestamps such as “Shot 1 [0-3s] wide shot...” to gain clearer narrative control.

\n\n

What are the limits for custom audio?

\n \n

audio_url supports mp3 and wav. Audio duration must be 2–30 seconds, and the file must not exceed 15MB. If the audio is longer than the video, it will be truncated; if it is shorter, the remaining video will be silent.

\n\n

Do I need to save the returned video link?

\n \n

Yes. The video_url returned after a successful task is valid for a limited time. Download it immediately or transfer it to permanent storage such as OSS or S3.

\n\n \n

", "ko": "

\n \n\n \n

\n \n

\n\n

\n \n \n \n \n Wan2.7 Text-to-Video API\n

\n\n

\n 프롬프트로
시네마틱 멀티샷 영상을 생성\n

\n Wanxiang 2.7 텍스트-투-비디오는 자연어 프롬프트로 부드러운 영상을 생성하는 모델입니다. 멀티샷 스토리텔링, 자동 오디오, 사용자 지정 오디오, 네거티브 프롬프트, 720P / 1080P 출력을 지원합니다.\n

\n\n

\n \n \n

\n\n

2–15 초

영상 길이

1080P

최고 해상도

화면 비율

\n\n

Prompt Timeline

15초 멀티샷 스토리

\n \n

\n\n

Shot 01

비 오는 밤거리 · 와이드 샷

Shot 02

인물 등장 · 미디엄 샷

Shot 03

표정 단서 · 클로즈업

\n\n

Async Task

\n CREATE\n RUNNING\n VIDEO URL\n

\n\n \n

핵심 영상 생성 기능

숏폼 영상 제작, 광고 클립, 스토리보드, 제품 쇼케이스 워크플로에 최적화되어 있습니다.

\n\n

\n \n

멀티샷 스토리텔링

prompt 로 단일 샷 또는 멀티샷 구조를 직접 제어할 수 있습니다. 타임스탬프를 사용해 각 샷의 구도, 동작, 서사 리듬도 설명할 수 있습니다.

\n\n

\n \n

자동 오디오 및 오디오 기반 입력

오디오를 입력하지 않으면 영상 내용에 맞춰 배경음악이나 효과음을 자동 생성할 수 있습니다. 또한 mp3 / wav 오디오 URL 을 사용자 지정 오디오 입력으로 사용할 수 있습니다.

\n\n

\n \n

720P / 1080P 출력

16:9, 9:16, 1:1, 4:3, 3:4 등 일반적인 화면 비율을 지원하여 가로형 광고, 세로형 숏폼 영상, 정사각형 소셜 콘텐츠를 모두 커버합니다.

\n\n

\n \n

제어 가능한 영상 길이

duration 은 2~15초 정수로 설정할 수 있어 미리보기, 편집, 게시에 적합한 짧은 영상 클립을 빠르게 생성할 수 있습니다.

\n\n

\n \n

Prompt 지능형 확장

prompt_extend 는 기본적으로 활성화되어 있습니다. 짧은 프롬프트를 지능적으로 확장하여 장면 디테일, 카메라 언어, 생성 안정성을 높입니다.

\n\n

\n \n

네거티브 프롬프트와 Seed

negative_prompt 는 원하지 않는 요소를 제한하는 데 사용할 수 있습니다. seed 는 결과 재현성을 높여 배치 테스트와 버전 비교에 유용합니다.

\n\n \n

Async Video Pipeline

작업 생성, 결과 폴링, 영상 저장

텍스트-투-비디오 작업은 일반적으로 몇 분이 걸리므로 HTTP 인터페이스는 비동기 호출을 사용합니다. 권장 워크플로는 생성 작업을 만들고 task_id 를 저장한 뒤, 적절한 간격으로 상태를 폴링하고, 성공 후 반환된 영상 링크를 즉시 다운로드하거나 별도 저장소로 이전하는 것입니다.

\n\n

Create Task

prompt, resolution, ratio, duration 등의 파라미터를 제출합니다.

Poll Status

task_id 로 PENDING, RUNNING, SUCCEEDED, FAILED 등의 상태를 조회합니다.

Download Video

성공 후 video_url 을 가져옵니다. 링크 유효 기간이 제한되어 있으므로 즉시 영구 저장소로 이전하는 것을 권장합니다.

\n\n \n

주요 API 파라미터

아래는 README 에 표시하기 좋은 핵심 파라미터 설명입니다. 연동 전에 모델의 기능 범위를 빠르게 이해하는 데 도움이 됩니다.

\n\n

파라미터	타입	필수	설명
model	string	예	권장 모델은 wan2.7-t2v-2026-04-25 또는 일반 버전 wan2.7-t2v 입니다.
input.prompt	string	예	영상에 포함할 요소, 동작, 카메라 샷, 시각 스타일을 설명합니다. 중국어와 영어를 지원하며 최대 5000자까지 입력할 수 있습니다.
input.negative_prompt	string	아니요	나오지 않았으면 하는 내용을 설명합니다. 최대 500자이며 화면 요소를 제한하는 데 사용됩니다.
input.audio_url	string	아니요	공개 또는 임시 오디오 URL 입니다. mp3 / wav 를 지원하며 길이는 2~30초, 파일 크기는 15MB 이하입니다.
parameters.resolution	string	아니요	영상 해상도 등급입니다. 720P, 1080P 를 지원하며 기본값은 1080P 입니다. 이 파라미터는 비용에 영향을 줍니다.
parameters.ratio	string	아니요	출력 화면 비율입니다. 16:9, 9:16, 1:1, 4:3, 3:4 를 지원하며 기본값은 16:9 입니다.
parameters.duration	integer	아니요	생성 영상 길이입니다. 단위는 초이며 값은 2~15, 기본값은 5 입니다. 초 단위로 과금됩니다.
parameters.prompt_extend	boolean	아니요	prompt 지능형 확장을 사용할지 여부입니다. 기본값은 true 이며 짧은 prompt 의 품질 개선에 적합합니다.
parameters.watermark	boolean	아니요	오른쪽 하단에 “AI 생성” 워터마크를 추가할지 여부입니다. 기본값은 false 입니다.
parameters.seed	integer	아니요	난수 시드입니다. 범위는 0~2147483647 입니다. seed 를 고정하면 결과 재현성을 높일 수 있습니다.

\n\n \n

화면 비율과 해상도

동일한 resolution 등급에서도 ratio 에 따라 출력 픽셀이 달라집니다. 가로형 영상, 세로형 숏폼, 정사각형 소셜 콘텐츠, 전통적인 화면 비율에 쉽게 대응할 수 있습니다.

720P / 16:9

1280×720

1080P / 16:9

1920×1080

720P / 9:16

720×1280

1080P / 9:16

1080×1920

\n\n

과금 안내

텍스트-투-비디오는 성공적으로 생성된 영상의 초 단위 길이에 따라 과금됩니다. 실패한 작업은 과금되지 않으며 무료 한도도 차감하지 않습니다. resolution 과 duration 은 최종 비용에 직접 영향을 주므로 제품 내에서 명확한 비용 예측을 제공하는 것이 좋습니다.

중국 본토 / 베이징

wan2.7-t2v / snapshot version

720P：0.6 위안/초

1080P：1 위안/초

국제 / 싱가포르

wan2.7-t2v / snapshot version

720P：0.733924 위안/초

1080P：1.100886 위안/초

가격은 공식 업데이트에 따라 변경될 수 있습니다. 출시 시점의 콘솔과 공식 요금 페이지를 기준으로 확인하세요.

\n\n \n

\n \n \n \n HTTP Request Example\n

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \\\n  -H 'X-DashScope-Async: enable' \\\n  -H \"Authorization: Bearer $DASHSCOPE_API_KEY\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"model\": \"wan2.7-t2v-2026-04-25\",\n    \"input\": {\n      \"prompt\": \"멀티샷 영상을 생성합니다. 샷 1[0-3초] 와이드 샷: 비 오는 밤의 도시 거리, 네온사인이 깜박입니다. 샷 2[3-6초] 미디엄 샷: 주인공이 건물 안으로 들어갑니다. 샷 3[6-10초] 클로즈업: 주인공이 중요한 단서를 발견합니다.\",\n      \"negative_prompt\": \"저품질, 흐림, 변형\"\n    },\n    \"parameters\": {\n      \"resolution\": \"1080P\",\n      \"ratio\": \"16:9\",\n      \"duration\": 10,\n      \"prompt_extend\": true,\n      \"watermark\": false,\n      \"seed\": 12345\n    }\n  }'

\n\n \n

자주 묻는 질문

Wan2.7 텍스트-투-비디오는 어떤 장면에 적합한가요?

\n \n

스토리보드, 숏폼 영상 광고, 제품 데모, 소셜 콘텐츠, 애니메이션 클립, 텍스트로 빠르게 영상 콘셉트 초안을 만들어야 하는 크리에이티브 워크플로에 적합합니다.

\n\n

단일 샷 또는 멀티샷을 어떻게 제어하나요?

\n \n

prompt 에 “단일 샷 영상 생성” 또는 “멀티샷 영상 생성”이라고 명확히 작성합니다. 멀티샷 장면에서는 “샷 1[0-3초] 와이드 샷……”처럼 타임스탬프를 넣으면 더 명확한 서사 제어가 가능합니다.

\n\n

사용자 지정 오디오에는 어떤 제한이 있나요?

\n \n

audio_url 은 mp3 와 wav 를 지원하며, 오디오 길이는 2~30초, 파일 크기는 15MB 이하입니다. 오디오가 영상보다 길면 잘리고, 영상보다 짧으면 나머지 구간은 무음으로 출력됩니다.

\n\n

반환된 영상 링크를 저장해야 하나요?

\n \n

네. 작업 성공 후 반환되는 video_url 은 유효 기간이 제한되어 있습니다. 결과를 받은 뒤 즉시 다운로드하거나 OSS, S3 등 영구 저장소로 이전하는 것을 권장합니다.

\n\n \n

" }

\n 用提示词生成电影级多镜头视频\n

15s Multi-shot Story

核心视频生成能力

多镜头叙事

自动配音与音频驱动

720P / 1080P 输出

可控时长

Prompt 智能改写

反向提示词与 Seed

创建任务、轮询结果、保存视频

Create Task

Poll Status

Download Video

关键 API 参数

画幅与分辨率

计费提示

常见问题解答

Wan2.7 文生视频适合什么场景？

如何控制单镜头或多镜头？

自定义音频有什么限制？

返回的视频链接需要保存吗？

\n プロンプトから映画品質のマルチショット動画を生成\n

15秒のマルチショットストーリー

主要な動画生成機能

マルチショット構成

自動音声生成と音声駆動

720P / 1080P 出力

制御可能な動画長

Prompt の自動拡張

ネガティブプロンプトと Seed

タスクを作成し、結果をポーリングし、動画を保存

Create Task

Poll Status

Download Video

主要 API パラメータ

画幅と解像度

料金メモ

よくある質問

Wan2.7 Text-to-Video はどんな用途に向いていますか？

単一ショットやマルチショットはどう制御しますか？

カスタム音声にはどんな制限がありますか？

返された動画リンクは保存する必要がありますか？

\n Generate cinematicmulti-shot videos from prompts\n

15s Multi-shot Story

Core Video Generation Capabilities

Multi-shot storytelling

Automatic audio and audio-driven input

720P / 1080P output

Controllable duration

Prompt enhancement

Negative prompt and Seed

Create tasks, poll results, and save videos

Create Task

Poll Status

Download Video

Key API Parameters

Aspect Ratios and Resolution

Pricing Notes

Frequently Asked Questions

What scenarios is Wan2.7 Text-to-Video suitable for?

How do I control single-shot or multi-shot videos?

What are the limits for custom audio?

Do I need to save the returned video link?

\n 프롬프트로시네마틱 멀티샷 영상을 생성\n

15초 멀티샷 스토리

핵심 영상 생성 기능

멀티샷 스토리텔링

자동 오디오 및 오디오 기반 입력

720P / 1080P 출력

제어 가능한 영상 길이

Prompt 지능형 확장

네거티브 프롬프트와 Seed

작업 생성, 결과 폴링, 영상 저장

Create Task

Poll Status

Download Video

주요 API 파라미터

화면 비율과 해상도

과금 안내

자주 묻는 질문

\n 用提示词生成
电影级多镜头视频\n

\n プロンプトから
映画品質のマルチショット動画を生成\n

\n Generate cinematic
multi-shot videos from prompts\n

\n 프롬프트로
시네마틱 멀티샷 영상을 생성\n

All Models