用途:调用阿里云 DashScope 的 Wan 2.7 图生视频模型 wan2.7-i2v,从图像生成视频,适用于首帧生成、首尾帧插值、视频续写和音频驱动等场景。
主要能力:首帧视频(仅需 first_frame);首尾帧插值(first_frame + last_frame);视频续写(first_clip);音频驱动(first_frame + driving_audio,用于口型同步、节奏驱动)。
使用方式:安装 dashscope SDK(python3 -m venv .venv、. .venv/bin/activate、python -m pip install dashscope),设置环境变量 DASHSCOPE_API_KEY 或在 ~/.alibabacloud/credentials 中配置 dashscope_api_key。接口为异步:POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis,请求头需 Authorization: Bearer $DASHSCOPE_API_KEY、Content-Type: application/json、X-DashScope-Async: enable;新加坡节点将域名替换为 dashscope-intl.aliyuncs.com。请求参数包括 prompt(最长 5000 字符)、negative_prompt(最长 500 字符)、media(必填,含 type 与 url,type 为 first_frame/last_frame/driving_audio/first_clip)、resolution(720P 或 1080P,默认 1080P)、duration(2-15 秒,默认 5)、prompt_extend(默认 true)、watermark(默认 false)、seed。创建任务后返回 output.task_id,有效 24 小时,需轮询任务状态(PENDING/RUNNING/SUCCEEDED/FAILED/CANCELED),成功后取 output.video_url。
媒体限制:图像支持 JPEG/JPG/PNG(无透明)/BMP/WEBP,单边 240-8000 像素,宽高比 1:8 至 8:1,最大 20MB;音频支持 wav/mp3,时长 2-30 秒,最大 15MB;视频支持 mp4/mov,时长 2-10 秒,单边 240-4096 像素,最大 100MB。
限制与注意:不可使用 wan2.7-i2v 之外的模型名;必须携带异步请求头;不可重复传入相同媒体类型;视频 URL 24 小时后失效,需及时下载保存;不用于视频编辑,编辑场景应使用 aliyun-wan-videoedit。输出默认保存至 output/aliyun-wan-i2v/videos/,可用 OUTPUT_DIR 覆盖。