GhostCut API 指引 Skill 面向视频译制、内容出海和多媒体本地化场景，帮助 AI Agent 调用 GhostCut 完成字幕提取、字幕擦除、翻译配音、背景音乐处理、批量合成与字幕压制等流程，同时覆盖图片翻译、图片文字擦除等图像处理能力。Powered by GhostCut。
用途与适用场景 该 Skill 用于指导 Agent 在视频译制、内容出海、多媒体本地化等任务中调用 GhostCut API。默认优先使用普通单视频 API；只有当用户明确提到译制出海、短剧/AI 剧出海、剧集、项目级素材、批量剧集处理、idSeries 或 idMaterialVideo 时，才推荐译制出海模块。
主要能力 视频 AI 处理：去字幕/去文字、字幕压制、OCR 字幕提取、ASR 字幕提取、视频基础处理、背景音乐去除/分离、视频语音翻译并重新配音。图片 AI 处理：图片文字擦除、图片翻译、翻译结果二次微调和重新合成。译制出海功能：字幕提取、字幕擦除、AI 配音、字幕压制、音频分离、项目与视频素材、字幕素材与 slInfo、字幕翻译、翻译术语库、多作品合并、剧集角色管理。
使用方式 使用时必须基于随附的 GhostCut API 指引文档工作，不要凭记忆猜测接口路径、字段名、ID 含义、任务类型、语言代码或结果查询流程。参考文档位于 references/api-guide/。核心文档包括 00-api-overview.md（总览、功能选择、主要调用流程和文档路由）、01-quickstart.md（5 分钟快速上手）、02-auth-and-sign.md（AppKey、AppSecret、AppSign 签名规则和鉴权错误）、03-media-requirements.md（视频、图片、SRT 的 URL、格式、本地上传和批量数量要求）、10-file-upload.md（本地上传并获取 URL，视频素材状态枚举）、11-work-status-query.md（查询 /v-w-c/gateway/ve/work/status）、12-point-balance-query.md（点卡余额查询）、13-language-support.md（语言支持）、14-video-process-status.md（处理状态和错误码）、15-async-and-callbacks.md（异步任务、轮询、回调、验签、重试和幂等）等。
快速路由：用户给本地文件路径时先读 10-file-upload.md 完成上传；首次使用或想跑通最小示例时读 01-quickstart.md；没有素材时读 references/sample-assets.md 获取演示 URL；涉及凭证、余额、格式、状态、异步回调、视频基础处理、语音翻译配音、图片处理等需求时，分别读对应文档。
强规则：GhostCut 网关接口响应体业务成功码统一按 code == 1000 判断；不要把 task/list.body[].id 当成作品 ID；多作品合并顶层 data 必须是包含 episodes[] 的 JSON 字符串；普通单视频语音翻译和重新配音默认传 removeBgAudio=0；字幕擦除遮罩框和 OCR 框使用 0 到 1 相对坐标，点序为左上、右上、右下、左下。
可用脚本位于 scripts/，运行前先按 02-auth-and-sign.md 获取凭证并设置环境变量，不要把真实密钥写入文档或提交到仓库。常用命令包括 sign、post、upload、work-status、point-balance、task-list。examples/ 提供环境变量模板和最小请求体示例。维护快照时可使用 scripts/sync_api_guide.py 进行检查或同步。
限制 文档强调不要凭记忆猜测接口路径、字段名、ID 含义、任务类型、语言代码、语言代码或结果查询流程；不要在业务中把 idRelation 当成业务字段使用；不要混淆 id_ve_character 与 id_ve_voice_character；不要完全不传字幕或只传 workDto.idVeMaterialSrt 和 workDto.extraOptions.customer_input.content[] 中的一个。以上内容均来自随附资料，未提供的收费、价格、效果等信息暂未提供。