跳转到主要内容
POST

认证

Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

生成模式

SkyReels V4 通过请求字段自动路由到对应模式,无需指定 mode 字段
严格互斥:I2V 字段(first_frame_image / end_frame_image / mid_frame_images)与 Omni 字段(ref_images / ref_videos)不能同时出现,否则返回 422。
@tag 机制:当使用 mid_frame_images / ref_images / ref_videos 时,每个元素需声明一个以 @ 开头的 tag(如 @image1@Actor-1@video1),并且 tag 必须出现在 prompt可以把 prompt 理解为”剧本”,tag 则是指向具体素材(图片 / 视频)的”角色指针”—— 例如 prompt 写 "@Actor-1 走进 @video1 的场景",系统据此将 @Actor-1 对应的参考图主体和 @video1 对应的动作参考注入到生成过程。

请求参数

通用字段

model
string
必填
支持以下两个档位:
必须显式传递 model 字段,无默认值。
计费与分辨率、是否使用 ref_videos 强相关:1080p 价格显著高于 480p / 720p;传入 ref_videos(带视频输入)的档位约为无视频输入的 1.5 ~ 2 倍。暂不支持音频和视频同时输出。
prompt
string
必填
文本提示词,最长 1280 tokens建议详细描述场景、主体、动作、风格等,以获得更好的生成效果。使用 ref_images / ref_videos / mid_frame_images 时,prompt必须包含 对应的 @tag(如 @Actor-1@video1@image1)。示例:"@Actor-1 walks through a neon-lit street at night."
duration
integer
默认值:"5"
输出视频时长(秒)
  • 取值范围:[3, 15]
  • 默认值:5
当传入 ref_videos.type=reference 时,duration 会被参考视频长度覆盖(上限 10 秒)。
resolution
string
默认值:"1080p"
视频分辨率可选值:
  • 480p
  • 720p
  • 1080p(默认)
aspect_ratio
string
默认值:"16:9"
宽高比可选值:
  • 16:9(默认)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
I2V 模式下 aspect_ratio 会被忽略(输出比例由输入图决定);Omni 带 ref_videos 时同样忽略。
prompt_optimizer
boolean
默认值:"true"
是否自动优化 prompt启用后,系统会自动优化您的提示词以获得更好的生成效果。

I2V 专用字段

first_frame_image
string
视频起始帧图片 URL(jpg / jpeg / png / gif / bmp)传入后将以该图片作为视频的起始画面
end_frame_image
string
视频结束帧图片 URL(jpg / jpeg / png / gif / bmp)传入后将以该图片作为视频的结束画面,可与 first_frame_image 组合实现首尾帧控制。
mid_frame_images
object[]
中间关键帧列表,最多 6 个。每个元素结构如下:

Omni 专用字段

ref_images
object[]
参考图列表(所有元素 type 必须一致)。每个元素结构如下:
ref_videos
object[]
参考视频列表,最多 1 个。每个元素结构如下:

支持的生成场景

以下场景 skyreels-v4-fastskyreels-v4-std 均支持

参数约束

以下约束违反时请求将被拒绝并返回 422,且 不产生计费

响应

code
integer
响应状态码,成功时为 200
data
array
返回数据数组

请求示例

场景 1:文生视频(最简)

场景 2:文生视频(完整参数)

场景 3:图生视频 - 首帧

场景 4:图生视频 - 首尾帧 + 中间关键帧

场景 5:Omni - 单主体参考

场景 6:Omni - 多主体 + 视频动作参考

此场景使用 ref_videos.type=reference请求的 duration 会被参考视频实际长度覆盖(上限 10 秒)。即便此处传 "duration": 5,最终视频长度以参考视频为准。

场景 7:Omni - 拼贴图(grid)

场景 8:Omni - 视频扩展(extend)

场景 9:Omni - 带声纹(语音同步)

查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。