视频转视频 API

用 GoEnhance 视频转视频 API 把视频风格化能力做进你的产品。先取一个当前可用的模型 ID,提交一个 HTTPS 源视频,选好时长和该模型支持的控制项,然后取回异步结果。本页介绍的是 GoEnhance 自有的 API,不代表与任何第三方风格品牌或模型品牌存在关联关系。
创建 API Key
电影感的行驶车辆画面,代表视频转视频 API 的风格转换

为 API 工作流打造的视频风格化

风格化的列车穿行于山地景观,构成一个电影感镜头
电影摄影机与光轨,象征可控的视频转换
每次发送转换请求前,先确认该模型支持哪些控制项。

视频转视频 API 能力

源视频

把 <code>reference_video_url</code> 传为公网可访问的 HTTPS MP4 或 MOV 文件。当前文档给出的最大文件体积是 50 MB。

模型与时长

传入风格列表端点返回的数字 <code>model</code> 值,以及必填的时长。文档给出的取值范围是 3–30 秒。

提示词与影响权重

对于支持的 V2 风格,可以使用可选的提示词,并用 <code>video_refer</code> 把侧重点调向提示词、居中平衡或源视频。

主体保留

支持该能力的请求可以保留识别到的人物或自定义主体、把主体单独抠出,或把主体放到指定的纯色背景上。

分辨率

文档中 V5 的分辨率选项是 <code>540p</code> 和 <code>720p</code>,其中 720p 为文档标明的默认值。

异步交付

保存返回的 <code>img_uuid</code>,然后轮询任务详情端点,或提供一个公网可访问的 HTTPS 回调地址来接收状态变更。
以账户里的实时价格为准,不要采信没有依据的统一定价说法。

视频转视频 API 价格参考

没有统一公布的固定单价

当前公开的视频转视频端点文档并未公布一个适用于所有风格、所有请求的固定价格。

查看当前的 GoEnhance API 价格

估算生产环境开销之前,先在你的 GoEnhance 账户或当前的价格页面确认所用模型的实际点数消耗。

按可用的请求组合做预算

先确定可用的模型,以及它支持的时长、分辨率和转换控制项,再估算成本;不要假设所有风格都套用同一套计费规则。

三步接入 GoEnhance API

1. 发现与校验
1

1. 发现与校验

在服务端创建 API Key,调用风格列表端点,选定一个当前可用的数字模型 ID,并校验源视频的 URL、文件类型、体积和请求时长。
2. 提交转换任务
2

2. 提交转换任务

带上 Bearer 鉴权,向 https://api.goenhance.ai/api/v1/video2video/generate 发 POST 请求,附上必填的 modeldurationreference_video_url 字段。只添加所选模型支持的控制项。
3. 处理异步任务
3

3. 处理异步任务

同时检查 HTTP 响应和 JSON 里的 code/msg,持久化 data.img_uuid,然后轮询 GET /api/v1/jobs/detail,或处理幂等的回调事件,直到任务成功或失败。
在需要可复用的服务端编排时,用模型驱动的风格化能力。

视频转视频 API 使用场景

动画与插画风格

把已获授权的素材重新风格化为动画、插画、水墨、黏土、像素或其他当前可用的视觉呈现。

多版本营销素材

用同一段动态素材产出多个不同的视觉方向,并把每个结果送进审核流程。

音乐与演出视觉

为短演出片段套上统一的视觉处理,同时保留原有的动作与节奏。

产品动态概念稿

在敲定最终制作方向之前,先用已有的产品素材试出风格化的动态方案。

角色与主体风格化

当流程需要把画面主角或自定义主体与背景区别处理时,使用模型支持的主体控制项。

自动化创意流水线

把上传、校验、任务跟踪、回调、审核、存储和分发串成一条可追溯的后端流程。
关于端点、源文件、价格、控制项和异步完成的解答。

视频转视频 API 常见问题

用视频转视频 API 开始构建