Menu
帮助用户使用 duo-video-api 模块的 HTTP 接口创建视频工程和视频创作任务。当需要通过 REST API 进行视频项目管理和任务调度时使用此技能。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | duo-video API 接口 |
| description | 帮助用户使用 duo-video-api 模块的 HTTP 接口创建视频工程和视频创作任务。当需要通过 REST API 进行视频项目管理和任务调度时使用此技能。 |
| compatibility | ["rest-api","http","video-management"] |
{
"code": 0, // 0 表示成功，非 0 表示失败
"msg": "success", // 一般在 code!=0时，会有值，表示错误原因
"data": { ... } // 具体响应数据
}
POST /api/video
请求参数:
{
"projectId": 123456789, // 可选，不传则自动生成
"projectName": "我的视频", // 可选，默认使用 projectId
"width": 1080, // 可选，默认 1080
"height": 1920, // 可选，默认 1920
"test": true // 可选，是否为测试模式
}
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"id": 123456789,
"projectName": "我的视频",
"width": 1080,
"height": 1920,
"test": true,
"scripts": [],
"materials": []
}
}
POST /api/project/global-style
请求参数:
{
"projectId": 123456789,
"styleId": 296653948753219540,
"textStyle": {
"fontSize": 28,
"bold": true,
"italic": true,
"textAlign": 1,
"fontName": "抖音美好体",
"fillColor": "#FFFF00",
"strokeColor": "#FF0000",
"strokeWidth": 10
},
"globalKeywordStyle": true // 是否设为全局关键词样式
}
POST /api/project/image
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0, // 分镜索引，默认 0
"imageId": 535010997887571096,
"imageUrl": "https://example.com/image.png",
"startTime": 3500, // 开始时间（毫秒）
"duration": 3000, // 持续时间（毫秒）
"layoutIndex": 1000, // 图层索引
"zoomX": 7500, // X 轴缩放（万分比）
"zoomY": 7500, // Y 轴缩放（万分比）
"positionX": 0, // X 轴位置
"positionY": -1512, // Y 轴位置
"rotate": -90, // 旋转角度
"visible": true, // 是否可见
"horizontal": true, // 水平翻转
"vertical": true // 垂直翻转
}
POST /api/project/video
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"videoId": 535010997887571021,
"videoUrl": "https://example.com/video.mp4",
"startTime": 0,
"duration": 3000,
"materialStart": 5000, // 素材开始位置（毫秒）
"materialTimeStart": 0, // 素材时间范围开始（毫秒）
"materialTimeEnd": 14264, // 素材时间范围结束（毫秒）
"layoutIndex": 1000,
"speed": 100, // 播放速度（百分比）
"zoomX": 10000,
"zoomY": 10000,
"rotate": 90,
"visible": true,
"horizontal": true,
"volume": 0, // 音量（-100 到 100）
"transitionId": 270404457990455297, // 转场特效 ID
"transitionDuration": 1000, // 转场持续时间
"greenBackground": { // 绿幕背景（可选）
"greenScreenId": 535010997887571022,
"greenScreenUrl": "https://example.com/green.png",
"chromaColor": "#4e8a1fff",
"chromaStrength": 20,
"chromaShadow": 10,
"chromaHighlight": 10
},
"mask": { // 蒙版（可选）
"maskId": 270415264124764161,
"feather": 5,
"rotation": 90,
"width": 0.5,
"height": 0.28,
"centerX": 0.07,
"centerY": 0.25,
"pointX": 400,
"pointY": 400
}
}
POST /api/project/audio
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"audioId": 535010997887571025,
"audioUrl": "https://example.com/audio.mp3",
"startTime": 0,
"duration": 8000,
"materialTimeStart": 170,
"materialTimeEnd": 126869,
"materialStart": 10000,
"layoutIndex": 1000,
"speed": 100,
"visible": true,
"volume": -50
}
POST /api/project/text
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"text": "测试中文字幕",
"startTime": 10,
"duration": 1990,
"layoutIndex": 1000,
"positionX": 0,
"positionY": -1000,
"rotate": 0,
"asSubtitle": true, // 是否作为字幕
"styleId": 296653948753219540, // 引用全局样式 ID（可选）
"style": { // 自定义样式（可选）
"fontSize": 14,
"bold": false,
"italic": false,
"textAlign": 1,
"fontName": "微软雅黑",
"fillColor": "#FFFFFF",
"strokeColor": "#FF0000",
"strokeWidth": 10
},
"wordStyles": [ // 逐字样式（可选）
{
"startIndex": 2,
"length": 2,
"fontSize": 16,
"fillColor": "#00FFFF",
"strokeWidth": 20,
"strokeColor": "#0000FF"
},
{
"startIndex": 3,
"length": 2,
"styleId": 296653948753219540,
"fontSize": 18,
"flowerId": 270413717936603137 // 花字 ID
}
]
}
POST /api/project/text-template
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"templateId": 270414005699805185,
"texts": ["非", "常", "棒", "duoec.com"],
"startTime": 2001,
"duration": 999,
"layoutIndex": 1000,
"zoomX": 5000,
"zoomY": 5000,
"positionX": 0,
"positionY": 1400
}
POST /api/project/sticker
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"stickerId": 270402997699280897,
"startTime": 1500,
"duration": 3000,
"zoomX": 5000,
"zoomY": 5000,
"positionX": 500,
"positionY": 0,
"rotate": -45
}
POST /api/project/video-effect
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"effectId": 270464037793497089,
"startTime": 5000,
"duration": 3000
}
POST /api/project/face-effect
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"effectId": 270464033541718017,
"startTime": 1500,
"duration": 1000
}
POST /api/project/sound
请求参数:
{
"projectId": 123456789,
"scriptIndex": 0,
"soundId": 270464042140893185,
"startTime": 1000,
"duration": 3000
}
POST /api/project/build
请求参数:
{
"id": 123456789,
"projectName": "我的视频",
"width": 1080,
"height": 1920,
"scripts": [...],
"materials": [...]
}
响应示例:
{
"code": 0,
"msg": "success",
"data": 987654321 // 视频构建任务ID
}
使用 curl 创建一个完整的视频项目：
# 1. 创建项目
curl -X POST http://localhost:8080/api/video \
-H "Content-Type: application/json" \
-d '{
"projectId": 123456789,
"projectName": "我的第一个视频",
"width": 1080,
"height": 1920,
"test": true
}'
# 2. 添加视频素材
curl -X POST http://localhost:8080/api/project/video \
-H "Content-Type: application/json" \
-d '{
"projectId": 123456789,
"videoId": 535010997887571021,
"videoUrl": "https://api.duoec.com/public/video/535010997887571021.mp4",
"startTime": 0,
"duration": 3000,
"zoomX": 10000,
"zoomY": 10000
}'
# 3. 添加文本
curl -X POST http://localhost:8080/api/project/text \
-H "Content-Type: application/json" \
-d '{
"projectId": 123456789,
"text": "Hello World",
"startTime": 0,
"duration": 3000,
"positionY": -800
}'
# 4. 构建视频
curl -X POST http://localhost:8080/api/project/build \
-H "Content-Type: application/json" \
-d '{
"id": 123456789,
"projectName": "我的第一个视频",
"width": 1080,
"height": 1920,
"scripts": [...],
"materials": [...]
}'