> 以下是 Azimo 开发者文档「工作流与视频类型」的 Markdown 版本，供 AI 助手参考。
> - Azimo（https://azimo.ai）是 AI 商业视频制作服务：一段文字加几份资料，交付一条通过质检的商用视频；提供异步 REST API、Python / TypeScript SDK、命令行 azimo 和 MCP 服务。
> - Base URL：https://azimo.ai
> - 鉴权：每个 /v1 请求带 `Authorization: Bearer <API key>`（在 https://azimo.ai/console#account 创建 Key）；用 `X-Project-ID` 选择项目，省略时使用默认项目。
> - 本页地址：https://azimo.ai/developers/workflows
> - 价格不公开：请联系 sales@azimo.ai。

# 工作流与视频类型

Azimo 提供六种现成的工作流，每种对应一类商业视频；本页说明各自适合做什么、要准备什么，以及最小的请求怎么写。

## 先看目录

| 工作流 | id | 画幅 | 时长（默认 / 范围） | 请求里怎么选 |
| --- | --- | --- | --- | --- |
| 项目介绍 | `project` | 16:9 | 60 秒 / 20–180 秒 | `workflow: explainer` + `video_type: project` |
| 人物名片 | `profile_card` | 9:16 | 60 秒 / 30–90 秒 | `workflow: profile_card` |
| 产品介绍 | `product` | 16:9 | 30 秒 / 20–180 秒 | `workflow: explainer` + `video_type: product` |
| 企业介绍 | `corporate` | 16:9 | 60 秒 / 20–180 秒 | `workflow: explainer` + `video_type: corporate` |
| 短剧广告 | `short_drama` | 9:16 | 30 秒 / 5–150 秒 | `workflow: short_drama` |
| 电商广告 | `ecommerce_ad` | 9:16 | 30 秒 / 5–120 秒 | `workflow: creative_video` |

自定义工作流即将推出。

`GET /v1/playground`（命令行 `azimo playground`）返回同一份目录，还会告诉你：这个账户现在能不能用（`available`，不能用时 `reason` 说明原因），以及每种工作流一个可以直接运行的示例。加 `?lang=en` 可取英文。

所有请求都发到 `POST /v1/plans`，方案 `ready` 后再用 `POST /v1/videos` 开始制作，见 [快速开始](https://azimo.ai/developers/quickstart)。时长用 `options.duration_max`（秒），画幅用 `options.width` 和 `options.height`：16:9 是 1920×1080，9:16 是 1080×1920，1:1 是 1080×1080。

## 项目介绍 project

**适合：** 向潜在客户或合作伙伴讲清一个项目。结构固定为“痛点 → 解决方案 → 优势”，最后落到一个下一步。

**要提供：** 用 `options.content_data` 填 7 个字段，缺一个都会返回 422。`project_name` 项目名称，`audience_role` 目标人群，`pain_scenario` 痛点场景，`solution_summary` 方案一句话定义，`solution_steps` 两三个运行步骤，`advantages_with_evidence` 优势及出处，`call_to_action` 下一步。有产品截图、试点总结等资料就一起上传。

```json
{
  "prompt": "语气稳重、清楚。",
  "options": {
    "workflow": "explainer", "video_type": "project", "duration_max": 60,
    "content_data": {
      "project_name": "北叶配送云",
      "audience_role": "拥有 5 至 30 家门店的社区生鲜连锁老板",
      "pain_scenario": "每天早上多家供应商分别送货，卸货口被堵，生鲜上架延迟。",
      "solution_summary": "一个共享送货排程服务，让门店和供应商按片区约定同一送货时段。",
      "solution_steps": "1）门店确认次日订货。2）平台按片区合并订单并推荐时段。3）司机按合并路线送货。",
      "advantages_with_evidence": "分散送货次数减少｜出处：客户提供的试点总结｜卸货口等待更短。",
      "call_to_action": "预约演示。"
    }
  }
}
```

## 人物名片 profile_card

**适合：** 竖版访谈式短片，介绍一个人的经历、专长和联系方式，便于转发。

**要提供：** 在 `prompt` 里写这个人的故事：姓名、职业、做过什么、客户评价、联系方式。上传一张清晰的本人照片，第一张图片会作为这个人的照片；没有照片时，片中人物不会是本人。简历、介绍等 TXT、MD、PDF 文件的内容会并入故事。画幅必须是 1080×1920。

```json
{
  "prompt": "周砚之，云杉木作工作室创始人。做了十二年家具设计，只用本地回收木料做定制家具。客户评价：书桌用了两年，抽屉还是一样顺滑。联系方式：工作室前台预约。",
  "assets": ["<本人照片的素材 ID>"],
  "options": {"workflow": "profile_card", "duration_max": 60, "width": 1080, "height": 1920}
}
```

如果只想要画外音加素材画面、不需要人物出镜，可以改用结构化类型 `personal`（`workflow: explainer`），字段见 `GET /v1/video-types`。

## 产品介绍 product

**适合：** 30 秒讲清产品适合谁、强在哪、怎么用，最后给一个明确的购买或咨询动作。

**要提供：** 7 个字段：`product_name` 产品名称，`audience_role` 适合谁，`usage_scenario` 使用场景，`main_benefits` 最多三个卖点，`demonstration` 可展示的使用动作，`evidence` 卖点依据，`purchase_action` 购买引导。强烈建议上传产品图和规格书；产品外观以你的图片为准。

```json
{
  "assets": ["<产品图的素材 ID>"],
  "options": {
    "workflow": "explainer", "video_type": "product", "duration_max": 30,
    "content_data": {
      "product_name": "普利瓦折叠旅行水壶",
      "audience_role": "经常出差住酒店的商务旅客",
      "usage_scenario": "深夜在酒店房间，想在睡前喝一杯热饮。",
      "main_benefits": "折叠后能放进电脑包；一次烧两杯水；壶盖锁紧不漏水。",
      "demonstration": "展开、接水、烧水、倒进杯子，再折叠压平。",
      "evidence": "客户提供的规格书和实拍测试素材。",
      "purchase_action": "到品牌官方商店搜索“普利瓦折叠旅行水壶”。"
    }
  }
}
```

## 企业介绍 corporate

**适合：** 一分钟呈现企业定位、主营业务、核心能力和实力证明，为合作洽谈开场。

**要提供：** 7 个字段：`company_name` 企业名称，`positioning` 企业定位，`audience_role` 目标受众，`core_business` 主营业务，`capabilities` 核心能力，`evidence` 实力依据，`cooperation_action` 合作方向。案例、资质、产线照片越具体越好。

```json
{
  "options": {
    "workflow": "explainer", "video_type": "corporate", "duration_max": 60,
    "content_data": {
      "company_name": "蕨岭包装科技有限公司",
      "positioning": "为电商和食品品牌提供可回收的保护性包装。",
      "audience_role": "有稳定发货量的电商和食品品牌",
      "core_business": "按产品定制的模塑纸浆托盘、快递内衬和衬垫。",
      "capabilities": "自有结构设计团队、模塑产线和测试实验室。",
      "evidence": "三家客户的合作案例和跌落测试报告，由客户提供。",
      "cooperation_action": "发来产品尺寸，申请样品。"
    }
  }
}
```

## 短剧广告 short_drama

**适合：** 30 秒左右、有起承转合的广告式小短剧，用故事把品牌带进观众记忆。

**要提供：** 在 `prompt` 里写清人物、场景、冲突和转折、语气，以及结尾的产品镜头和品牌语。可以附上 TXT、PDF、PPTX 形式的剧本或品牌资料。支持 16:9、9:16、1:1。

```json
{
  "prompt": "30 秒广告短剧，虚构品牌“暖灯咖啡”。深夜，疲惫的设计师小林发现桌上有一杯手冲咖啡和室友留的便签：“明天的方案我帮你检查过了，去睡吧。”她笑着喝下第一口，灯光变暖。结尾出产品镜头和品牌语。",
  "options": {"workflow": "short_drama", "duration_max": 30, "width": 1080, "height": 1920}
}
```

## 电商广告 ecommerce_ad

**适合：** 竖版电商广告，用商品细节和日常使用场景，让人愿意点进商品页。

**要提供：** 上传商品图和包装图，这是最重要的素材。在 `prompt` 里写商品、画面、色调、旁白风格，以及哪些话不能说（例如不做功效宣传）。素材不够时，视频可能停在 `needs_input` 请你补充。支持 16:9、9:16、1:1。

```json
{
  "prompt": "30 秒竖版电商广告：青叶茶晶，茉莉绿茶和炭焙乌龙两种口味，独立条包，冷热皆可。画面有茶晶在玻璃杯中化开的微距和两款包装并排；温和女声旁白。只使用包装图上有的信息，不做功效宣传。",
  "assets": ["<包装图的素材 ID>"],
  "options": {"workflow": "creative_video", "duration_max": 30, "width": 1080, "height": 1920, "subtitles": true}
}
```

## 交付前我们检查什么

每条视频交付前都要过自动检查，具体检查项随工作流略有不同。结果在视频的 `result.qa` 里。

- **规格：** 分辨率、帧率和时长符合请求，有音轨，整条片子能完整解码。
- **结构：** 结构化片型的每一段都在，顺序正确；需要依据的段落引用了你提供的资料。
- **内容：** 回听成片旁白，核对该讲的内容都讲了，数字和单位没有丢。
- **品牌与文字：** 品牌名读对；片尾的品牌、联系方式和购买引导完整显示，不被裁切。
- **画面：** 逐个镜头检查画面质量，纯文字画面也要过同样的检查；横版素材放进竖版时保留完整画面。
- **声音：** 旁白完整不截断，音画同步，片尾留足阅读时间。
- **不编造：** 没有依据的数字、履历、案例和效果不会出现在片子里。
- 任何一项不通过，视频状态是 `rejected`，不会标成 `complete`。

## 怎样写好 brief

- 一句话说清三件事：讲什么、给谁看、看完做什么。
- 写具体的人和场景（“深夜酒店房间里的出差旅客”），不要写“广大用户”。
- 卖点最多三个，每个都给出处或能拍出来的演示。
- 只写你能证明的数字；没有数据就写实际做法。
- 名称、品牌语、联系方式一字不差地写出来，它们会原样出现在片中。
- 上传真实的产品图、照片和资料；外观和人物以你的素材为准。
- 说明不能出现的内容，例如促销、功效宣传、竞品名称。
- 时长选在工作流支持的范围内；方案返回 `needs_input` 时，先看 `requirements`。

完整字段见 [API 参考](https://azimo.ai/developers/api)。