1简介
1.1服务能力简介
只需输入一张图片(首帧或尾帧)或两张图片(首尾帧),天幕AI即刻生成5秒动态视频! 想精准控制画面效果?输入图片+文本描述,即可定义主体运动轨迹与背景动态演化。我们提供标准(720P)与高清(1080P)两档模式,全面覆盖短视频创作、影视预演、广告特效等场景。通过首帧锚定起点、首尾帧定义关键动作,结合物理引擎模拟真实运动(重力/流体/碰撞)与电影级运镜(推拉摇移/环绕),带大家将静态图像转化为空间纵深的动态画面,大幅降低专业视频创作门槛!
1.2效果展示
|
输入图片 |
prompt |
输出视频 |
|
|
猫咪可爱疑惑的表情 |
2Prompt engine
以上公式最核心的构成是主体和运动,与文生视频不同,图生视频已经有了场景,因此只需要描述图像中的主体与希望主体实现的运动,如果涉及多个主体的多个运动,依次列举即可,「万兴天幕AI」会根据我们的表达与对图像画面的理解进行提示词扩写,生成符合预期的视频。
如果想要 “让画中的女孩戴上耳机”,当我们只输入“戴耳机”时,模型较难理解指令,因此更可能通过自己的判断进行视频生成,当「天幕AI」判断这是一幅画时,会更可能生成具有运镜的效果的画幅展览,这也是照片类的图片容易生成静止不动视频的原因(不要上传带有相框的图片)。因此,我们需要通过描述“主体+运动"来让模型理解指令,如“维米尔画作《戴珍珠耳环的少女》突然转头,右手拿起无线耳机戴在耳朵上”,或者对于多主体"戴珍珠耳环的少女右手拿起无线耳机戴在耳朵上,珍珠耳环微微晃动”,模型会更容易响应。
|
提示词=主主体+运动,背景+运动
|
一些tips
-
尽量使用简单词语和句子结构,避免使用过于复杂的语言;
-
运动符合物理规律,尽量用图片中可能发生的运动描述;
-
描述与图片相差较大,可能会引起镜头切换;
-
现阶段较难生成复杂的物理运动,比如球类的弹跳、高空抛物等;
3API接入
3.1请求地址(POST 请求)
https://open-api.wondershare.cc/v1/open/capacity/application/tm_img2video_b
3.2请求参数
Header:
|
参数名称 |
参数值 |
是否必须 |
示例 |
备注 |
|
Content-Type |
application/json |
是 |
|
|
|
X-App-Key |
{app_key} |
是 |
xxxxxx |
分配的appkey |
|
Authorization |
Basic {access_token} |
是 |
Basic xxx |
安全验证信息,格式为:Basic {access_token},其中access_token为令牌,通过给的app_key和app_secret生成,生成方式为:base64(app_key:app_secret) |
Body:
|
名称 |
类型 |
是否必须 |
默认值 |
备注 |
|
prompt |
string |
必须 |
|
提示词 支持中英文 建议:需要有主体+动作+镜头说明 |
|
camera_move_index |
integer |
非必须 |
|
运镜控制类型 1: "orbit", 2: "spin", 3: "pan left", 4: "pan right", 5: "tilt up", 6: "tilt down", 7: "push in", 8: "pull out", 9: "static", 10: "tracking", 11: "others", 12: "object pov", 13: "super dolly in", 14: "super dolly out", 15: "snorricam", 16: "head tracking", 17: "car grip", 18: "screen transition", 19: "car chasing", 20: "fisheye", 21: "FPV drone", 22: "crane over the head", 23: "timelapse landscape", 24: "dolly in", 25: "dolly out", 26: "zoom in", 27: "zoom out", 28: "full shot", 29: "close-up shot", 30: "extreme close-up", 31: "Macro shot", 32: "bird's-eye view", 33: "rule of thirds", 34: "symmetrical composition", 35: "handheld", 36: "FPV shot", 37: "jib up", 38: "jib down", 39: "full shot", 40: "Time lapse shot", 41: "aerial shot", 42: "low angle shot", 43: "Eye-level shot", 44: "diagonal composition", 45: "over shoulder shot", 46: "crane down", |
|
image |
string |
必须 |
|
图片URL链接。 1.图片应小于200M,无最小值限制; 2. 长宽比:16:9、9:16、4:3、3:4、1:1 、original; 3. 分辨率无限制,输入图片720P以上效果好,720P以下效果下降,建议图片分辨率满足短边大于720px; 4. 图片格式:JPG、JPEG、PNG、WEBP |
|
resolution |
string |
非必须 |
720p |
生成视频分辨率。支持 720p、1080p |
|
duration |
integer |
非必须 |
5 |
生成视频时长(秒)。支持 5 |
|
aspect_ratio |
string |
非必须 |
16:9 |
生成的视频宽高比。支持 :16:9、9:16、4:3、3:4、1:1、original 。输入输出建议保持一致,不一致时会裁剪,可能会跟预期结果不符 |
|
callback |
string |
非必须 |
|
回调地址 |
|
params |
string |
非必须 |
|
透明参数 |
返回数据:
|
名称 |
类型 |
是否必须 |
默认值 |
备注 |
|
code |
integer |
必须 |
|
错误码 |
|
msg |
string |
必须 |
|
错误文案 |
|
data |
object |
非必须 |
|
|
|
├─ task_id |
string |
非必须 |
|
任务id |
3.3 请求示例
curl --location 'https://open-api.wondershare.cc/v1/open/capacity/application/tm_img2video_b' \
--header 'X-App-Key: xxxxxx' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxx' \
--data '{
"prompt": "跳舞",
"image": "url",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9",
"params": "xxxxxx",
"callback": "http://xxxxxx.com",
}'
3.4 响应结果
-
创建任务接口返回结果:
{
"code": 0,
"msg": "",
"data": {
"task_id": "tob_img2video_customize-0-20251030142332ce81af45d50049e3a3"
}
}
