跳到主要内容
Axiom Lab
开发者文档

开发者

用 API 制作商用视频

Azimo 的全部能力都可以通过 REST API、Python 与 TypeScript SDK、命令行和 MCP 调用：上传素材，先看方案，确认后制作，质检通过才交付。

获取 API Key五分钟上手

文档

01

快速开始

拿到 Key、上传素材、创建方案、确认制作、取回成片：五步跑通第一条视频。

阅读 →02

工作流与视频类型

六种工作流各适合讲什么、需要哪些素材、交付什么。

阅读 →03

命令行与 MCP

用命令行 azimo 制作视频，或把 Azimo 接入 Claude、Cursor 等 AI 助手。

阅读 →04

进阶用法

Webhook、批量制作、幂等重试、分页和错误处理。

阅读 →05

API 参考

每个接口的参数、请求体、返回字段和 curl 示例，由线上接口定义实时生成。

阅读 →06

Skills

把 Azimo 技能交给 Claude：先出方案、确认后制作、取回成片。

阅读 →07

更新日志

API、命令行和控制台的变化，按时间倒序。

阅读 →

第一个请求

四步：上传素材、创建方案、确认制作、取回结果。把 $AZIMO_API_KEY 换成你的 Key。

# 1. 上传素材（PDF / PPTX / TXT / MD / PNG / JPG，60 MB 以内）
curl -X POST "https://axiomlab.online/v1/assets" -H "Authorization: Bearer $AZIMO_API_KEY" -F file=@product.pdf

# 2. 创建方案：先看制作流程、规格和缺什么，还没有开始制作
curl -X POST "https://axiomlab.online/v1/plans" -H "Authorization: Bearer $AZIMO_API_KEY" \
  -H "Idempotency-Key: launch-plan-001" -H "Content-Type: application/json" \
  -d '{"prompt":"用三十秒向仓库负责人讲清库存平台如何减少缺货","assets":["<asset id>"]}'

# 3. 确认方案，开始制作 → 202
curl -X POST "https://axiomlab.online/v1/videos" -H "Authorization: Bearer $AZIMO_API_KEY" \
  -H "Idempotency-Key: launch-video-001" -H "Content-Type: application/json" -d '{"plan_id":"<plan id>"}'

# 4. 查询进度，完成后拿到下载链接
curl "https://axiomlab.online/v1/videos/<video id>" -H "Authorization: Bearer $AZIMO_API_KEY"

安装 SDK 与命令行

# Python SDK、命令行 azimo 和 MCP 服务在同一个包里（Python 3.9+）
pip install ./sdk/python
azimo login            # 粘贴 API Key，验证通过才保存

TypeScript SDK 在仓库的 sdk/typescript，零依赖，Node.js 22+ 或现代浏览器可用。

接入 AI 助手（MCP）

在 Claude、Cursor 等支持 MCP 的客户端里直接创建方案、提交制作、查询进度。本地运行或连远程服务，二选一：

claude mcp add azimo -- azimo mcp
claude mcp add --transport http azimo https://axiomlab.online/mcp --header "Authorization: Bearer $AZIMO_API_KEY"

让 AI 助手读懂文档

每一页顶部都有“一键复制给 LLM”，会把这一页连同 Azimo 的基本信息以 Markdown 复制下来。也可以把这些地址直接交给 AI 工具：