用途:基于火山引擎 VOD 对音视频进行编辑、媒体处理与 AI 内容分析/生成,适合批量或自动化调用 VOD 能力的场景。
前置条件:Python 版本需 ≥3.6;需配置环境变量 VOLCENGINE_ACCESS_KEY、VOLCENGINE_SECRET_KEY、VOD_SPACE_NAME,也可放在工作目录 .env 文件由脚本自动加载;脚本依赖 python-dotenv。调用脚本前必须查看对应详细参数说明。
参数传入:支持内联 JSON(python script.py '{"key":"value"}')和文件引用(python script.py @params.json,@ 前缀从当前工作目录读取 JSON)。
主要能力:视频编辑类含拼接 stitching、裁剪 clipping、翻转 flip、变速 speedup、图片转视频 image_to_video、音视频合成 compile、提取音轨 extract_audio、混音 mix_audios;媒体处理类含人声分离 voice_separation、降噪 noise_reduction、画质修复 quality_enhance、超分 super_resolution、补帧 interlacing;内容分析类含 ASR、OCR、硬字幕擦除 subtitle_removal、添加字幕 add_subtitle、智能场景分割 intelligent_slicing、人像抠图 portrait_matting、绿幕抠像 green_screen、高光剪辑 highlight、媒资查询 get_media_info;生成类含漫剧转绘 comic_style、视频翻译 video_translation、解说视频 drama_recap、剧本还原 drama_script。
使用方式:本地文件或 http(s) 链接需先用 scripts/upload_media.py "<local_file_path_or_http_url>" [space_name] 上传,输出 Source 字段即 vid://...,后续脚本以此引用。本地上传仅允许 workspace/、userdata/ 和 /tmp 目录下文件。提交异步任务后返回 VCCreativeId 或 TaskId,交付产物时必须包含该异步任务 id,且不得修改产物链接。超时可用 poll_vcreative.py、poll_media.py、poll_translation.py 重启轮询,resume_hint.command 给出可直接执行的命令。错误统一返回 {"error": "说明"}。
限制:需火山引擎账号与 VOD 资源;计费仅在用户主动咨询时参考 references/00-billing-instructions.md 说明 VOD 资源计费构成。具体价格、可用平台等资料暂未提供。