用途:通过阿里云 DashScope 的 HappyHorse 1.0 文生视频模型 happyhorse-1.0-t2v,仅凭文本提示词生成写实视频。仅适用于纯文本生视频,不支持图片或视频条件生成,那类需求应改用 i2v、r2v 或 videoedit 技能。
主要能力:文本生视频,必需输入为 prompt,最长 5000 个非中日韩字符或 2500 个中日韩字符,超出会被截断;可选参数 resolution(720P/1080P,默认 1080P)、ratio(16:9 默认、9:16、1:1、4:3、3:4)、duration(3 至 15 秒,默认 5)、watermark(默认 true,右下角加 Happy Horse 水印)、seed(0 至 2147483647)。
使用方式:接口仅支持异步。创建任务用 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。轮询用 GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id},建议间隔 15 秒。创建后返回 output.task_id 与 task_status(PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED、UNKNOWN);成功后返回 output.video_url(MP4、H.264)。依赖安装:python3 -m venv .venv、. .venv/bin/activate、python -m pip install requests;需设置环境变量 DASHSCOPE_API_KEY,或向 ~/.alibabacloud/credentials 添加 dashscope_api_key。
适用场景:纯文本提示词的短视频、竖版短片、可控分辨率与比例的写实视频生成。
限制:不得用其他模型 ID;必须异步,缺少 async 头会报不支持同步调用;不得传 media、first_frame、reference_image。视频与任务 URL 24 小时后过期,须及时下载持久化;task_id 超过 24 小时返回 UNKNOWN。常见错误含 401(密钥无效)、400(参数不支持或时长越界)、429(限流,可退避重试)。