img_uuid，然后用轮询或 HTTPS 回调取回结果。面向自动化创作流程的 AI 视频特效 API
通过独立的 GoEnhance API 调用 AI 视频特效。先列出可用的特效模板，再带上特效 ID 提交一张已获授权的参考图，保存返回的
创建 API Key
AI 视频特效 API 的能力
创建任务前，先确认凭证、素材可访问性、模板标识和回调配置都没问题。
AI 视频特效 API 请求要点
Bearer 鉴权
在 <code>Authorization</code> 请求头里传 GoEnhance API Key，并且只把它放在服务端，绝不要写进客户端代码。
模板发现
在产品里展示特效选项之前，先用 <code>GET /api/v1/videoeffect/list</code> 拉取当前的模板清单。
参考图
在 <code>reference_img</code> 中传入可公开访问的 HTTPS 图片地址，且只使用你拥有版权或已获授权处理的素材。
特效标识
传入所选模板准确的 <code>effect_id</code>；用最新的列表返回结果去校验它，不要凭猜测拼标识符。
可选回调
如果希望把状态通知推送到公开的 HTTPS 端点，就填上 <code>custom_callback_url</code>。
异步任务 ID
把提交成功后响应里的 <code>data.img_uuid</code> 持久化，并与你内部的请求记录关联起来。
以实时的模板数据和文档为准，不要沿用臆测或过期的通用价格。
AI 视频特效 API 价格
价格随特效而变
AI 视频特效 API 的价格取决于所选模板以及 GoEnhance 当前的特效目录。不要假设所有特效都是同一个固定单价。
查询实时目录
对于你打算调用的特效，请以模板列表接口和 GoEnhance 最新文档为准。
提交前先估算成本
在把生产批次排入队列之前，先确认所选的 <code>effect_id</code> 及其当前的计费细则，因为目录条款可能变动。
三步接入 AI 视频特效
1
1. 获取清单并校验
拉取特效列表，选定准确的
effect_id，并确认你的 HTTPS 参考图可以访问、且已获授权用于处理。 2
2. 提交并落库
POST 提交
reference_img、effect_id 和可选的回调地址，然后保存响应里的 data.img_uuid。 3
3. 取回终态结果
轮询
GET /api/v1/jobs/detail?img_uuid=...，或者幂等地处理回调报文，直到任务进入 success 或 failed。围绕你拥有版权、或已获许可进行改编的内容，搭建可复用的特效工作流。
AI 视频特效 API 应用场景
创作者工具
让用户在你的应用里挑选已审核的特效，把已获授权的静态图片变成短小的动态素材。
营销素材变体
为营销创意排队生成多种特效版本，同时把素材版权、内容审核与审批环节留在你自己的流程里。
UGC 流水线
在一条可追溯的后端流水线里串起上传、特效选择、异步处理和结果交付。
娱乐化体验
在明确取得同意并做好内容合规检查的前提下，做用户自愿开启的趣味玩法与主题动画功能。
批量创作运营
把任务 ID 持久化，并独立处理终态结果，这样批量任务超时后可以恢复，而不会重复提交。
媒资自动化
只有在校验过终态响应之后，才把完成的视频送入存储、复核、审核和发布系统。
关于端点、价格、输入参数、异步交付和生产环境防护措施的解答。