核心用法
OpenClaw Media Gen 是一款基于 AIsa API 的统一媒体生成工具,用户仅需配置 AISA_API_KEY 即可调用两大模型能力:
图片生成:基于 Google Gemini 3 Pro Image Preview 模型,通过 generateContent 端点直接生成图像,支持自然语言描述生成高质量图片,响应以 inline_data 形式返回 base64 编码图像数据。
视频生成:基于阿里巴巴通义万相 Wan 2.6 模型,采用异步任务架构。需先创建视频合成任务(支持图文生视频),再通过轮询接口查询任务状态,最终获取生成视频。支持 720P 分辨率、5 秒时长等参数配置。
工具提供完整的 Python 客户端脚本,封装了图片生成、视频任务创建、状态轮询、自动下载等全流程操作,同时保留原生 curl 示例供高级用户调试。
显著优点
- 一站式接入:单一 API 密钥打通 Gemini 与 Wan 2.6 两大生态,无需分别注册 Google Cloud 和阿里云账号
- 异步架构合理:视频生成采用标准异步模式,避免长连接阻塞,支持超时与轮询策略配置
- 客户端脚本完善:Python CLI 覆盖从创建到下载的完整链路,降低集成门槛
- 文档索引清晰:基于 Mintlify 构建的 API 参考体系,支持
llms.txt机器可读索引
潜在缺点与局限性
- 供应商锁定风险:依赖 AIsa 作为中间聚合层,若 AIsa 服务中断或调整合作方,将直接影响功能可用性
- 异步调试复杂:视频任务需手动管理 task_id 与轮询逻辑,失败重试、状态异常处理需用户自行实现
- 功能黑盒化:文档未披露具体模型版本、配额限制、计费模式等关键商业条款
- 环境依赖:要求本地具备 python3 与 curl,对纯云端或容器化场景不够友好
适合人群
- 需要快速验证 Gemini 图像生成与 Wan 2.6 视频生成能力的开发者
- 希望避免多云账号管理的中小团队与个人创作者
- 具备基础 Python 能力、能接受异步任务模型的技术用户
常规风险
- API 密钥泄露:
AISA_API_KEY作为单一凭证,若硬编码或日志泄露可能导致账户被盗用 - 成本不可控:异步任务可能因队列拥堵产生意外等待,生成失败是否计费、是否支持回调通知等机制未明确
- 内容合规:AI 生成媒体涉及版权与 deepfake 风险,需用户自行确保输出内容符合当地法规