特效视频
更新时间：2025-04-11
本接口用于创建场景特效任务
注意事项:
- 图片 URL 需要确保公网可访问
- 提示文本有最大长度限制， 其中 V 为 1500 个字符，P 为 2048 字符
图片上传流程：
操作指南：
- 不同特效有不同的使用指南和限制，具体请查看文档 特效视频使用指南
在线调试
平台提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用，更多内容请查看API在线调试介绍。
调试成功后返回的 taskId 用于后续查询任务状态， 参考 查询任务详情。
请求结构
POST /v2/aigc/create_effect_video HTTP/1.1
connection: keep-alive
host: vod.bj.baidubce.com
content-type: application/json
x-bce-request-id: <bce-request-id>
x-bce-date: <utc-date-string>
authorization: <bce-authorization-string>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| model | string | 是 | 模型名称, 支持：
|
| modelVTaskInput | EffectVideoVTaskInput | 否 | V 模型的特定输入参数 |
| modelPTaskInput | EffectVideoPTaskInput | 否 | P 模型的特定输入参数 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| taskId | string | 任务id |
请求示例
生成拥抱特效场景
请求内容
POST /v2/aigc/create_effect_video HTTP/1.1
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
content-type: application/json
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
x-bce-date: 2024-03-24T13:08:44Z
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"model": "V",
"modelVTaskInput": {
"effect": "hug",
"images": [
{
"imageUrl": "https://vod-resource.cdn.bcebos.com/videos/hug.png"
}
]
}
}生成换发特效场景
请求内容
POST /v2/aigc/create_effect_video HTTP/1.1
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
content-type: application/json
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
x-bce-date: 2024-03-24T13:08:44Z
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"model": "V",
"modelVTaskInput": {
"effect": "hair_swap_twin_tails",
"images": [
{
"imageUrl": "https://vod-resource.cdn.bcebos.com/videos/hair_swap_twin_tails_1.jpeg"
}
],
"hairSwapInput": {
"hairColor": "Sweet Cherry Pink"
}
}
}生成财神发金币特效场景
请求内容
POST /v2/aigc/create_effect_video HTTP/1.1
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
content-type: application/json
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
x-bce-date: 2024-03-24T13:08:44Z
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"model": "V",
"modelVTaskInput": {
"effect": "wish_sender_coin_rain",
"images": [
{
"imageUrl": "https://vod-resource.cdn.bcebos.com/videos/wish_sender_coin_rain_1.jpeg"
},
{
"imageUrl": "https://vod-resource.cdn.bcebos.com/videos/wish_sender_coin_rain_2.png"
},
{
"imageUrl": "https://vod-resource.cdn.bcebos.com/videos/wish_sender_coin_rain_3.png"
}
]
}
}生成古风换装特效场景
请求内容
POST /v2/aigc/create_effect_video HTTP/1.1
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
content-type: application/json
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
x-bce-date: 2024-03-24T13:08:44Z
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"model": "V",
"modelVTaskInput": {
"effect": "dynasty_dress_swap",
"aspectRatio": "9:16",
"images": [
{
"imageUrl": "https://vod-resource.cdn.bcebos.com/videos/dynasty_dress_swap.png"
}
]
}
}生成我们是毒液特效场景
请求内容
POST /v2/aigc/create_effect_video HTTP/1.1
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
content-type: application/json
x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
x-bce-date: 2024-03-24T13:08:44Z
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
{
"model": "P",
"modelPTaskInput": {
"effect": "we_are_venom",
"prompt": "变身毒液",
"duration": 5,
"image": {
"imageUrl": "https://vod-resource.cdn.bcebos.com/videos/character1.5_1.png"
},
"resolution": "540p"
}
}