AdCraft 多模型配置指南:一键接入即梦、可灵、MiniMax 等主流图片、视频与音频生成平台
AdCraft 多模型配置指南:一键接入即梦、可灵、MiniMax 等主流图片、视频与音频生成平台
AdCraft 是首个面向营销广告的 Agentic 视频制作平台,支持多模型配置:你只需在内置的配置中心填入一次 API Key,即可一键接入即梦、可灵、MiniMax 等主流图片、视频与音频生成平台,从创意到成片全自动生产。
为什么 AdCraft 支持多生成平台?
做广告视频通常需要三类 AI 能力:图片生成(商品图、角色设定图、分镜图)、视频生成(把分镜变成动态镜头)、音频生成(BGM、音效、配音)。
如果绑定单一模型,一旦某个平台限流、服务不稳定或模型不擅长你的风格,整条生产链路就会卡住。AdCraft 的做法是:
- 不绑定单一生成模型,同一环节可切换不同平台的模型
- 默认平台 + 备用平台:主平台失败时自动重试或换平台,生产更稳定
- 统一配置中心:API Key、默认模型、比例、清晰度、时长等参数集中管理
AdCraft 支持哪些生成平台?
| 能力 | 支持的主流平台 |
|---|---|
| 🖼️ 图片生成 | 即梦、豆包/Seedream、通义万相、腾讯混元图像、MiniMax Image 等 |
| 🎥 视频生成 | Seedance、即梦、可灵 Kling、海螺 Hailuo、Vidu、通义万相 Wan、腾讯混元视频等 |
| 🎵 音频生成 | MiniMax Speech/Music、CosyVoice、豆包语音、腾讯云语音、讯飞星火语音、百度智能云语音等 |
| 💬 文本大模型 | SiliconFlow(GLM 等)、OpenRouter 等,负责创意策划、脚本等推理环节 |
各平台模型的后端适配与凭据管理集中在 apps/api/app/services/provider_credentials.py 与 apps/api/app/services/provider_adapter_registry.py 中,内置火山方舟(Ark)、SiliconFlow、MiniMax、OpenRouter、天谱乐等服务商凭据定义,无需手工修改配置文件。
一键接入步骤:进入 API Space 配置中心
AdCraft 的设计是"先部署、后填 Key"——启动时不需要任何供应商 API Key,所有凭据都在网页里完成:
- 先按中文启动指南完成部署(可参考 Docker 部署教程 或非 Docker 教程)
- 打开本机网页地址(通常以
http://127.0.0.1:开头) - 进入 API Space 页面,选择你要接入的服务商
- 按页面提示填写对应能力的 API Key:文本(llm)、图片(image)、视频(video)各自独立,只填你实际使用的即可
- 点击保存,如页面提供连接测试,建议跑一次确认 Key 有效(成功后会返回连接成功及模型名)
配置中心的前端实现见 apps/web/src/pages/ApiSpacePage.tsx,每个服务商的凭据状态都会以掩码形式展示,方便随时检查是否已配置。
常用生成参数如何设置?
保存 Key 后,还可以在同一配置中心统一管理生成参数:
- 默认模型:为图片、视频、音频环节分别指定默认模型
- 画面比例:16:9(横版广告)、9:16(短视频投流)、1:1 等
- 清晰度与时长:视频分辨率(如 720p)、每段镜头时长
- 开关项:视频是否生成配音音频、是否加水印
- 备用平台:设置默认平台与备用平台,某环节失败时自动切换
不同环节可以选择不同平台:比如用即梦做分镜图、用可灵 Kling 做视频、用 MiniMax Music 做 BGM,灵活组合出最适合你广告风格的技术栈。
安全与网络注意事项
- 🔐 API Key 保存在本机的
apps/api/.env中,界面只显示掩码。请像密码一样对待它:不要提交到 Git、不要粘贴到聊天或公开文档 - 💰 生成媒体会产生按量计费,先确认账户余额、模型权限与账单权限再批量生产
- 🌐 国内用户使用 Docker 部署并开了代理时,记得把
volces.com、siliconflow.cn、tianpuyue.cn、minimaxi.chat等国内服务商域名加入代理绕过列表(No Proxy),否则可能出现APIConnectionError等传输错误。详细说明见 README_zh.md 中的"国内网络配置"一节
常见问题
| 问题 | 处理办法 |
|---|---|
| API Space 保存或测试 Key 失败 | 检查 Key 是否正确、账户是否有余额/配额、模型权限是否开通、网络能否直连该服务商 |
生成报 APIConnectionError 或 SSL: UNEXPECTED_EOF |
多半是新服务商域名没加进代理绕过列表,补充域名后重试 |
| 某环节频繁失败 | 在配置中心设置备用平台,失败会自动换平台重试 |
按以上步骤完成多模型配置后,打开 AdCraft 首页,描述你的广告需求,即可体验"从创意到成片"的全自动多模型生产链路。
登录后查看全文


