最新天工AI API批量生成短视频脚本完全指南
天工AI现已推出基于HTTP调用的脚本生成API,当前仅面向企业认证用户开放。如需跳过网页前端,直接通过程序批量生成数十条短视频脚本,则需对接其后端接口。以下逐步拆解完整接入流程。
使用门槛集中于企业认证与身份核验。具体配置方法详见下文。
核实天工AI脚本生成API开放状态
访问天工AI最新开发者文档(developer.tiangong.ai),依次导航至「产品能力」→「视频创作」→「脚本生成」核实接口状态。仅标记为「已上线」且注明「支持HTTP调用」的接口方可执行批量任务。若页面仅显示「Web端可用」,表明该功能尚未开放API,无法通过程序调用。
截至2026年6月,天工AI仅向认证企业账户开放「/v1/script/generate」接口,个人开发者暂无法调用脚本生成功能。
注册企业账号并申请API访问权限
第一步:使用企业营业执照完成实名认证,登录天工AI控制台;
第二步:进入「API管理」→「新建应用」,填写应用名称(例如“短视频脚本工厂”),回调域名设置为localhost即可;
第三步:在权限列表中勾选「script:generate」与「text:embed」两项权限,提交审核。审核周期通常为1-3个工作日,审核通过前所有调用请求均会返回403错误。
构建符合规范的请求体
方法一:通过curl命令行快速测试
复制以下curl命令,将YOUR_API_KEY替换为控制台生成的真实密钥,保存为generate.sh后直接执行:
curl -X POST "https://api.tiangong.ai/v1/script/generate"
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"prompt": "一位健身教练在健身房演示深蹲动作,强调膝盖不过脚尖,画面分三段:全景展示环境→中景聚焦腿部角度→特写呼吸节奏",
"length": "30s",
"style": "教学纪实"
}'
方法二:使用Python requests库进行批量调用
准备CSV文件scripts_input.csv,每行包含prompt、length、style三列。利用pandas读取后,循环发送POST请求。每次请求需携带有效Bearer Token,且prompt字段不得超过800字符,否则将返回400错误。
解析返回JSON结构并提取脚本内容
第一步:确认响应状态码是否为200;
第二步:在response.json()中查找「script_text」字段,其值即为可直接用于配音的口播文案;
第三步:如需获取结构化分镜信息,读取「scenes」数组,每个元素包含scene_id、visual_description、voiceover和duration四个字段。需注意,返回结果不含精确到帧的时间信息,duration仅为预估秒数,实际剪辑时需自行校准。
