指南
工作流与视频类型
六种工作流各适合讲什么、需要哪些素材、交付什么。
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 开始制作,见 快速开始。时长用 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 下一步。有产品截图、试点总结等资料就一起上传。
{
"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。
{
"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 购买引导。强烈建议上传产品图和规格书;产品外观以你的图片为准。
{
"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 合作方向。案例、资质、产线照片越具体越好。
{
"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。
{
"prompt": "30 秒广告短剧,虚构品牌“暖灯咖啡”。深夜,疲惫的设计师小林发现桌上有一杯手冲咖啡和室友留的便签:“明天的方案我帮你检查过了,去睡吧。”她笑着喝下第一口,灯光变暖。结尾出产品镜头和品牌语。",
"options": {"workflow": "short_drama", "duration_max": 30, "width": 1080, "height": 1920}
}
电商广告 ecommerce_ad
适合: 竖版电商广告,用商品细节和日常使用场景,让人愿意点进商品页。
要提供: 上传商品图和包装图,这是最重要的素材。在 prompt 里写商品、画面、色调、旁白风格,以及哪些话不能说(例如不做功效宣传)。素材不够时,视频可能停在 needs_input 请你补充。支持 16:9、9:16、1:1。
{
"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 参考。