天工AI现已推出支持HTTP调用的脚本生成API,但该功能目前仅面向企业认证账号开放。若希望绕过网页界面,通过程序一次性批量生成数十条短视频脚本,就需要对接其后端接口。接下来,我们将逐步梳理整个流程。

使用该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命令行快速测试
复制下方命令,将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仅为预估秒数,实际剪辑时仍需自行校准。
