接口总览

服务地址：https://your-domain.example/api

所有接口都需要在请求头带上 X-API-Key（/health 除外）。

当前服务实现了草稿管理、素材编辑、关键帧、特效、滤镜和素材元数据查询等接口。

大模型或 Agent 第一次接入时，先阅读大模型用法，里面给出了调用顺序、GET/POST 选择和完整示例。

草稿管理

接口	功能	方法	路径
create_draft	创建草稿	POST	`/create_draft`
save_draft	保存草稿	POST	`/save_draft`
export_draft	导出草稿	POST	`/export_draft`
query_draft_status	查询任务状态	POST	`/query_draft_status`
query_script	查询草稿脚本	POST	`/query_script`
generate_draft_url	生成下载地址	POST	`/generate_draft_url`
list_projects	项目列表	GET	`/list_projects`
read_project	读取项目	POST	`/read_project`
reload_desktop	重载桌面	GET	`/reload_desktop`

素材信息

接口	功能	方法	路径
get_duration	获取音视频时长	POST	`/get_duration`

视频

接口	功能	方法	路径
add_video	添加视频	POST	`/add_video`

音频

接口	功能	方法	路径
add_audio	添加音频	POST	`/add_audio`
get_audio_effect_types	音频特效	GET	`/get_audio_effect_types`

图像

接口	功能	方法	路径
add_image	添加图片	POST	`/add_image`

文字与字幕

接口	功能	方法	路径
add_text	添加文字	POST	`/add_text`
add_subtitle	添加字幕	POST	`/add_subtitle`
add_text_style	富文本样式	POST	`/add_text_style`
get_text_effects	花字效果	GET / POST	`/get_text_effects`
get_font_types	字体列表	GET	`/get_font_types`
get_text_intro_types	文字入场动画	GET	`/get_text_intro_types`
get_text_outro_types	文字出场动画	GET	`/get_text_outro_types`
get_text_loop_anim_types	文字循环动画	GET	`/get_text_loop_anim_types`

转场

接口	功能	方法	路径
get_transition_types	转场类型	GET	`/get_transition_types`

蒙版

接口	功能	方法	路径
get_mask_types	蒙版类型	GET	`/get_mask_types`
add_masks	添加蒙版	POST	`/add_masks`
add_mask_keyframes	蒙版关键帧	POST	`/add_mask_keyframes`

关键帧

接口	功能	方法	路径
add_video_keyframe	画面关键帧	POST	`/add_video_keyframe`

特效

接口	功能	方法	路径
get_video_scene_effect_types	场景特效	GET	`/get_video_scene_effect_types`
get_video_character_effect_types	人物特效	GET	`/get_video_character_effect_types`
add_effect	添加特效	POST	`/add_effect`

贴纸

接口	功能	方法	路径
search_sticker	搜索贴纸	POST	`/search_sticker`
add_sticker	添加贴纸	POST	`/add_sticker`

滤镜

接口	功能	方法	路径
get_filter_types	滤镜类型	GET	`/get_filter_types`
add_filter	添加滤镜	POST	`/add_filter`

美颜与美型

接口	功能	方法	路径
add_beauty	美颜、美型、美妆、美体	POST	`/add_beauty`

动画

接口	功能	方法	路径
get_intro_animation_types	入场动画	GET	`/get_intro_animation_types`
get_outro_animation_types	出场动画	GET	`/get_outro_animation_types`
get_combo_animation_types	组合动画	GET	`/get_combo_animation_types`