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