用途:调用阿里云 DashScope 的 HappyHorse 1.0 图生视频模型(happyhorse-1.0-i2v),输入恰好一张首帧图片,可选配文本提示,生成一段视频;输出画幅比例自动跟随输入图片,不支持 ratio 参数。
主要能力:模型固定为 happyhorse-1.0-i2v;输入 input.media 恰含一个 type 为 first_frame 的元素,其 url 须为公开 HTTP/HTTPS 地址;parameters.resolution 可选 720P 或 1080P(默认 1080P);duration 为 3 至 15 秒(默认 5);watermark 默认 true(右下角 Happy Horse 水印);seed 范围 0 至 2147483647。首帧图片格式限 JPEG、JPG、PNG、WEBP,宽高均不小于 300 像素,宽高比 1:2.5 至 2.5:1,最大 10 MB。
使用方式:接口仅支持异步,先 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.aliyuncs.com 换为 dashscope-intl.aliyuncs.com。随后以约 15 秒间隔轮询 GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id},直到任务状态为 SUCCEEDED、FAILED 或 CANCELED。需先安装依赖:python -m pip install requests,并设置 DASHSCOPE_API_KEY,或在 ~/.alibabacloud/credentials 中添加 dashscope_api_key。成功后取得 output.video_url(MP4、H.264、24fps)。
限制:任务 ID 与视频 URL 均仅 24 小时有效,须及时下载保存;不得同步调用,须携带异步头;不得传超过 1 张首帧,也不支持 last_frame、reference_image 或视频输入;不要传 ratio;纯文生视频、参考图融合、视频编辑应分别使用 aliyun-happyhorse-t2v、aliyun-happyhorse-r2v、aliyun-happyhorse-videoedit。常见错误包括 401 InvalidApiKey、400 InvalidParameter、缺少异步头、task_status 为 UNKNOWN(任务超 24 小时)、429 超配额,可重试并退避。默认输出目录为 output/aliyun-happyhorse-i2v/videos/,可用 OUTPUT_DIR 覆盖。