​

Muse 视频

muse-video 通过统一视频接口提交 JSON 异步任务，支持文生视频、首帧生视频和多图参考。创建任务后，使用返回的任务 ID 查询状态并下载结果。

​

接口路径

请求域名统一使用 https://magic666.top，创建、查询和代理下载均使用 Authorization: Bearer YOUR_API_KEY 鉴权。

​

模型与参数

​

生成方式

图片使用服务端可以访问的公网 HTTP(S) URL，本地图片需要先上传为公网 URL。单张首帧使用 image 字符串；参考生视频使用非空 images 数组，并保留预期的图片顺序。多图参考不接收 Base64 data URI 或 asset://。 参考生视频至少提供一张图片。第一张图片用于起始画面，后续图片用于内容参考，不作为指定尾帧。此接口不提供独立尾帧、参考视频或参考音频字段。

​

异步任务流程

1. 提交 POST /v1/videos，保存响应中的 id 或 task_id。
2. 使用 GET /v1/videos/{task_id} 轮询状态，建议间隔 5 到 10 秒。
3. 状态为 completed、succeeded 或 success 时，优先读取 result.url 并保存视频。
4. 没有可用直链时，使用带鉴权的 GET /v1/videos/{task_id}/content 尝试代理下载。

video_transfer.upload_error 表示结果转存出现问题。若任务已经完成且存在 result.url，应先尝试下载该地址；不要仅因转存失败就重新提交生成任务。

​

创建与查询

​

推荐阅读

1. Muse 视频生成
2. Muse 查询视频任务
3. 视频模型支持矩阵