跳转到主要内容
POST
cURL
muse-video-r2v 生成忠于你所关心对象成片。它不锁定某一帧,而是让你交出一到四张参考图——一个角色、一件商品、一个场景——它围绕这些参考构图,在全片保持身份与材质细节。

模型速览

参数

每张参考图的作用

每张参考图只聚焦一件事。一张图里塞两个互相抢戏的主体,会把成片往两个方向拉扯。

提示词写法

描述发生什么,而不是主体长什么样——外观已经由参考图承载了。点明镜头和运动通常就够了。
如果参考图是商品,写动作而不是写物体:写「一只手拿起瓶子」,不要写「一个白色玻璃瓶」。关于参考图的形容词很容易被当成风格改动重新施加。

调用流程

  1. 带 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-r2v"
prompt
string
必填

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

Required string length: 1 - 4000
image_urls
string[]
必填

必填。1-4 张参考图(人物、商品或场景),视频会保持与之一致。

Required array length: 1 - 4 elements

参考图公网 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
必填