Wan API入门指南
使用REST API将Wan AI集成到您的应用程序的完整指南。包含代码示例。
Developer Team
Wan AI
本文介绍如何通过阿里云百炼平台的REST API调用Wan视频生成能力，覆盖认证、接口、参数和SDK。
获取API Key
在百炼平台（bailian.console.aliyun.com）注册开通模型服务，创建API Key。新账户有免费额度。Key格式为sk-开头，不要硬编码到前端代码。
核心工作流
视频生成为异步操作：1）提交任务获取task_id；2）轮询状态；3）下载视频。耗时1-5分钟，取决于分辨率和时长。
文生视频接口
POST /v1/services/aigc/video-generation。请求体含model（如wan2.1-t2v-14b）、input.prompt、parameters.resolution（480p/720p/1080p）、parameters.duration（秒）。响应返回task_id。
图生视频接口
同一地址，model换wan2.1-i2v-14b。额外参数input.image_url指定源图片（JPEG/PNG，建议不低于512x512），或用input.image_base64传base64数据（请求体上限10MB）。
状态查询
GET /v1/tasks/{task_id}。status为RUNNING/SUCCEEDED/FAILED。成功后output.video_url含下载链接（24小时有效）。轮询间隔建议5秒。
Python SDK
pip install dashscope后调用dashscope.VideoGeneration.call()即可，SDK封装了轮询逻辑直接返回结果。也支持JavaScript和Go。
计费与限制
免费额度用尽后按量计费，并发默认5个任务，积分永不过期。视频链接有时效需及时保存。批量场景建议webhook回调替代轮询。
