SuperAPI AI 工具集

descript-api

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:无需打开 Descript 应用,即可编程创建项目、导入媒体并调用 Agent Underlord 完成 AI 剪辑。状态为早期访问,端点有限且仍在演进。

认证:使用环境变量 DESCRIPT_API_KEY(存于 ~/.zshrc 与 ~/.descript-cli/config.json)。注意必须用小写 authorization 请求头,大写 Authorization 会返回 401。

主要端点:POST /jobs/import/project_media 导入媒体、创建项目并自动转写;POST /jobs/agent 用自然语言提示 Underlord 剪辑(一次性,无多轮对话);GET /jobs/{job_id} 轮询状态;DELETE /jobs/{job_id} 取消任务;GET /status 确认认证;GET /published_projects/{slug} 获取已发布项目元数据与字幕。GET /jobs 列表功能尚未可用。

用法:导入时媒体 URL 需公开可访问并支持 HTTP Range,签名有效期建议 12-48 小时;目前只能新建项目,不支持导入到已有项目;FPS 与语言设置会被忽略(自动检测)。Agent 任务约 30-90 秒,每合成约 14-18 AI 积分,可选 model 参数(如 haiku-4.5、sonnet-4.5、opus-4.6、gemini-3.1-pro、gpt-5.4、automatic)。任务状态含 queued、running、stopped、cancelled。

CLI:npm install -g @descript/platform-cli@latest,随后 descript-api config set api-key、descript-api import、descript-api agent。

限制:跨驱动器编辑返回 403;Agent 任务偶发 502 可重试一次;无列出项目端点;自定义布局包经 API 不可用,需在应用内手动应用;429 时参考 Retry-After 等响应头。