跳转到主要内容
POST
cURL
muse-video-i2v 让一张静态图动起来。传一张图,它就是首帧;传两张图,Muse Video 会在首帧到尾帧之间插值出一段镜头,让你精确控制运动从哪里开始、在哪里结束。

模型速览

参数

通过 reference_images 传图在这里会被拒绝——那个别名属于 muse-video-r2v,它把每张图都当主体参考而不是关键帧。

只传首帧 vs 首尾帧

需要精确落在某个构图上时,首尾帧是最可靠的做法。提示词里描述过程即可,两个端点模型已经知道了。

调用流程

  1. 带 first_frame_image(可选在 image_urls 里再传一项)调用 POST /v1/videos/generations。
  2. 取 data.task_id。
  3. 轮询 GET /v1/videos/status/{task_id} 直到 completed。
  4. 从 data.result 下载。

图片要求

  • 使用可直接访问的公网 HTTPS 地址。会过期的签名链接、开了防盗链的域名、需要登录才能打开的地址都会在提交阶段失败。
  • 人像、商品、风景都可以;首帧里的主体不要被遮挡。
  • 真人照片尽量用光线充足的中远景——极近特写能给模型发挥的空间很小。

费用

按输出秒计费,且与参考生视频不同,这里的关键帧不计入费用:时长 × 每秒单价。

授权

Authorization
string
header
必填

使用 APIPod API Key 作为 Bearer token 放在 Authorization 请求头。

请求体

application/json
model
string
必填

APIPod 公开模型 ID。

Allowed value: "muse-video-i2v"
prompt
string
必填

视频内容描述,必填,最多 4000 个字符。

Required string length: 1 - 4000
first_frame_image
string
必填

必填。首帧图片的公网 URL。在 image_urls 中传第二个 URL(最多两个)即可作为尾帧。

duration
enum<integer>
默认值:5

视频时长(秒)。

可用选项:
5,
10,
20,
30,
40,
50,
60
aspect_ratio
enum<string>
默认值:16:9

生成视频的画幅比例。

可用选项:
16:9,
9:16,
1:1,
4:3,
3:4
resolution
enum<string>
默认值:720p

输出清晰度。MU Video 目前仅支持 720p。

可用选项:
720p
style_preset
enum<string>
默认值:none

视频风格预设。

可用选项:
none,
cinematic_realistic,
2d_anime,
3d_xianxia,
american_comic,
cyberpunk_neon,
ecommerce_ugc
generate_audio
boolean
默认值:true

是否生成人声与音效。设为 false 即静音人声。

响应

200 - application/json

任务已受理

任务提交标准响应

code
integer
必填
data
任务提交数据 · object
必填

任务提交数据体

message
string
必填