1. 开放接口
云幕 ts
  • 开放接口
    • 【第一步】文件上传初始化
      POST
    • 【第二步】文件上传完成检测
      POST
    • 【第三步】创建任务-精细任务-与自动任务二选一
      POST
    • 【第四步】提交精细任务参数
      POST
    • 任务操作(查询、修改)
      POST
    • 重新创建任务
      POST
    • 文本翻译【单句翻译】
      POST
  1. 开放接口

【第四步】提交精细任务参数

开发中
POST
/features/task/params/{task_id}
最后修改时间:2025-12-27 03:48:53
user_params的参数:
{
"file_id": "file_1766801283854_6655a6293860",
"file_name": "短剧片段.mp4",
"file_type": "video",
"oss_url": "https://cdn-proxy.56tool.com/temp/yunmuts/20251227/video_translation_pro/file_1766801283854_6655a6293860.mp4", // 视频链接
"local_mount_path": "/home/oss/temp/yunmuts/20251227/video_translation_pro/file_1766801283854_6655a6293860.mp4",
"duration": 23, // 时长
"file_size": 34223262,
"width": 1080, // 视频宽度
"height": 1920, // 视频高度
"origin_language": "zh", // 视频语言
"target_language": "en", // 目标语言
"open_sub": true, // 是否开启字幕遮罩条
"mask_area": [ // 遮罩条的位置,x,y,w,h
0,
1221,
1080,
183
],
"sub_bar_style": 0, // 遮挡条的样式 0 是高斯模糊遮挡
"subtitle_style": { // subtitle_style 同 title_style
"font_size": 35,
"font_name": "Noto Sans", // "Noto Sans" "Roboto" "IBM Plex Sans" "Nunito" "Montserrat" "Aleo" "Abril Fatface" "Chunk" "Gats"
"font_bold": 1,
"font_italic": 0,
"font_underline": 0,
"alignment": "center",
"font_color": "FFFFFF",
"outline_enabled": false,
"outline_color": "000000",
"outline_size": 2,
"background_enabled": true,
"background_color": "000000",
"background_opacity": 255
},
"subtitle_show": 2, // 字幕展示 0:只显示原文, 1:只显示译文 ,2:双语字幕
"margin_v": 535, // 字幕距离底部的距离
"save_instrumental": true, // 保存人声分离的音频
"use_bgm": false, // 是否使用 bgm
"use_title": true, // 是否开启标题 如果为 false 则 title_style 不生效
"auto_excute": true, // 是否自动执行
"title_text": "测试标题", // 标题内容
"title_style": { // 标题样式
"font_size": 54, // 标题字体大小
"font_name": "Noto Sans", // 字体样式
"font_bold": 1, // 是否加粗
"font_italic": 0, // 是否斜体
"font_underline": 0, // 是否下划线
"alignment": "center", // 居中显示
"font_color": "000000", // 字体颜色
"outline_enabled": false, // 开启字体边框 边框与背景二选一
"outline_color": "000000",// 字体边框颜色
"outline_size": 2,// 边框大小
"background_enabled": true,// 开启背景 边框与背景二选一
"background_color": "FACC15",// 背景颜色
"background_opacity": 255 // 背景透明度
},
"title_margin_v": 50 // 标题距离顶部的距离
}

请求参数

Path 参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.yunmuts.com/api/v1/features/task/params/' \
--header 'X-API-Key: {{api-key}}' \
--header 'X-API-Secret: {{api-secret}}' \
--form 'user_params="{\"file_id\":\"file_1766801283854_6655a6293860\",\"file_name\":\"短剧片段.mp4\",\"file_type\":\"video\",\"oss_url\":\"https://cdn-proxy.56tool.com/temp/yunmuts/20251227/video_translation_pro/file_1766801283854_6655a6293860.mp4\",\"local_mount_path\":\"/home/oss/temp/yunmuts/20251227/video_translation_pro/file_1766801283854_6655a6293860.mp4\",\"duration\":23,\"file_size\":34223262,\"width\":1080,\"height\":1920,\"origin_language\":\"zh\",\"target_language\":\"en\",\"open_sub\":true,\"mask_area\":[0,1221,1080,183],\"mast_style\":0,\"sub_bar_style\":0,\"subtitle_style\":{\"font_size\":35,\"font_name\":\"Noto Sans\",\"font_bold\":1,\"font_italic\":0,\"font_underline\":0,\"alignment\":\"center\",\"font_color\":\"FFFFFF\",\"outline_enabled\":false,\"outline_color\":\"000000\",\"outline_size\":2,\"background_enabled\":true,\"background_color\":\"000000\",\"background_opacity\":255},\"subtitle_show\":2,\"margin_v\":535,\"save_instrumental\":true,\"use_bgm\":false,\"use_title\":true,\"auto_excute\":true,\"title_text\":\"测试标题\",\"title_style\":{\"font_size\":54,\"font_name\":\"Noto Sans\",\"font_bold\":1,\"font_italic\":0,\"font_underline\":0,\"alignment\":\"center\",\"font_color\":\"000000\",\"outline_enabled\":false,\"outline_color\":\"000000\",\"outline_size\":2,\"background_enabled\":true,\"background_color\":\"FACC15\",\"background_opacity\":255},\"title_margin_v\":50}"' \
--form 'update_ts="[{        \"index\": 1,        \"text\": \"我会找到逆转时间的公式\",        \"translated_text\": \"I will find the formula to reverse time.\",        \"start_time_ms\": 30,        \"end_time_ms\": 2330,        \"audio_status\": 3,        \"cdn_url\": \"https://tts.crcfirst.com/mp3/segment_001.mp3\"      }]"'

返回响应

🟢200成功
application/json
Body

示例
{}
修改于 2025-12-27 03:48:53
上一页
【第三步】创建任务-精细任务-与自动任务二选一
下一页
任务操作(查询、修改)
Built with