Yollomi AI Image & Video Generator

核心用法

Yollomi AI API Skill 是一个统一端点的多模态AI生成平台，通过单一API接口 /api/v1/generate 调用多种图像和视频生成模型。

图像生成流程：

• 文本生成图像：提供 prompt 和 aspectRatio（支持 1:1/16:9/9:16）
• 背景移除：modelId: remove-bg + imageUrl（零积分消耗）
• 高级编辑：人脸替换、物体移除、照片修复、AI扩图、虚拟试穿等

视频生成流程：

• 支持文生视频和图生视频两种模式
• 覆盖 Sora、Veo 3、Kling 2.1、Runway Gen4 等一线模型
• 注意：当前skill版本视频功能被临时禁用

统一接口设计：所有模型通过 type（image/video）和 modelId 参数区分，大幅降低集成复杂度。

显著优点

1. 模型生态丰富：涵盖20+图像模型（Flux系列、Stable Diffusion 3.5、Imagen 4、Ideogram等）和15+视频模型
2. 积分体系透明：明确标注每张/每秒消耗积分，remove-bg甚至免费
3. 企业级功能：虚拟试穿、批量背景生成、专业级图像修复等电商/营销场景功能
4. 灵活鉴权：支持 Bearer Token 和 X-API-Key 两种头部认证方式

潜在局限

• 视频功能当前不可用：文档明确标注临时禁用，需关注后续版本
• 第三方API依赖：服务稳定性与Yollomi平台绑定
• 无本地模型选项：纯云端方案，不适合离线场景
• 积分成本需精细化管理：高阶模型如 Flux-2-Pro（15积分/张）、Wan 2.6（29积分/次）成本较高

适合人群

• 内容创作者：快速生成社交媒体配图、短视频素材
• 电商运营：虚拟试穿、产品背景替换、批量修图
• 营销设计团队：广告素材A/B测试、多版本快速产出
• 开发者集成：需要统一API管理多供应商AI能力的项目

常规风险

• API密钥泄露：环境变量 YOLLOMI_API_KEY 管理不当可能导致积分被盗刷
• 生成内容合规：AI生成的人物、场景需遵循平台内容政策，存在审核风险
• 成本失控：视频生成单条可达50+积分，高频调用需设置预算警报
• 服务连续性：临时功能禁用提示供应商侧可能存在不稳定性

核心用法

Yollomi AI API Skill 提供单一统一端点 /api/v1/generate，通过 type 和 modelId 参数区分图像/视频生成与具体模型。图像生成支持 Flux 系列、Stable Diffusion 3.5、Imagen 4 等 20+ 模型，涵盖文生图、图生图、背景移除、智能扩图、老照片修复、虚拟试穿等场景；视频生成（当前版本暂时禁用）支持 Sora 2、Kling、Veo 3 等主流模型。

典型工作流：
1. 配置 YOLLOMI_API_KEY 环境变量
2. 调用 POST /api/v1/generate 传入 type（image/video）、modelId 及模型专用参数（prompt、imageUrl 等）
3. 接收返回的 URL 数组或视频链接及剩余积分

积分机制：图像 1-15 积分/张，视频 7-50+ 积分/次，背景移除零积分。

显著优点

• 统一端点设计：所有模型共用同一接口，降低集成复杂度
• 模型生态丰富：覆盖开源（Flux、SD3.5）与商业模型（Imagen 4、Sora、Kling）
• 零第三方依赖：运行时无外部库，攻击面极小
• 安全合规优秀：CLS 认证 S 级（88 分），六维安全扫描全通过
• HTTPS 强制加密：TLS 1.2+ 传输，无数据外泄风险

潜在缺点与局限性

• 视频功能暂不可用：当前构建版本已禁用，需等待后续更新
• 积分成本较高：高端模型（Flux-2-Pro 15 积分、Sora 50+ 积分）使用成本显著
• 外部服务依赖：完全依赖 Yollomi 平台可用性与定价策略
• 无本地回退：网络中断或 API 故障时无离线能力
• 许可证未声明：开源协议不明，商业使用需谨慎

适合人群

• 需要快速集成多模型 AI 图像生成的开发者与产品团队
• 对安全合规要求较高的企业级场景（已通过 GDPR 最小化原则验证）
• 需要背景移除、图像修复等增值图像处理功能的用户
• 愿为高质量视频生成支付积分成本的创作者（待功能恢复）

常规风险

| 风险类别 | 说明 | 缓解建议 |

|---------|------|---------|

| API 密钥泄露 | 环境变量配置不当可能导致密钥暴露 | 使用密钥管理系统，避免硬编码 |

| 服务中断 | Yollomi 平台故障影响全部功能 | 实现熔断降级与重试机制 |

| 内容合规 | AI 生成内容可能涉及版权/伦理问题 | 建立人工审核流程 |

| 成本控制 | 高消耗模型易超预期支出 | 设置积分预算告警 |

| 数据隐私 | prompt 与图片上传至第三方服务器 | 避免上传含 PII 的敏感图像 |