Yollomi AI Image & Video Generator

核心用法

Yollomi AI API 是一个多模型聚合的生成式AI平台，通过单一REST端点 POST /api/v1/generate 提供图像与视频生成能力。开发者只需替换 modelId 参数即可切换底层模型，无需适配不同厂商的API规范。

图像生成流程：设置 YOLLOMI_API_KEY → 调用 /api/v1/models 获取可用模型 → 选择 modelId（如 flux、imagen-4-ultra）→ 提交prompt与 aspectRatio（1:1/16:9/9:16）→ 获取图片URL数组。

进阶功能覆盖：背景移除（remove-bg，0积分）、图像修复（photo-restoration）、智能扩图（image-upscaler）、虚拟试穿（virtual-try-on）、人脸替换（face-swap）、对象擦除（object-remover）及Qwen图像编辑等，形成完整视觉工作流。

视频生成：支持OpenAI Sora 2、Google Veo 3系列、Kling 2.1、Runway Gen4、MiniMax Hailuo等主流模型，计费从7-50+积分不等，当前版本视频功能已临时禁用。

显著优点

• 统一接口，降低集成成本：单一端点替代多家厂商SDK，切换模型仅改参数
• 模型覆盖全面：图像涵盖Flux全系列、Stable Diffusion 3.5、Google Imagen 4、Ideogram V3等；视频聚合Sora、Veo、Kling等一线模型
• 精细化计费：图像1-15积分/张，视频7-50+积分，支持按需成本控制
• 实用工具链：0积分背景移除、1积分超分等低价高频功能完善

潜在局限

• 视频功能不稳定：当前构建版本已禁用视频生成，生产环境需确认可用性
• 生态封闭性：相比直接使用OpenAI、Google等官方API，Yollomi作为中间层存在单点故障风险
• 文档深度不足：部分模型参数细节需依赖外部 models-reference.md 或运行时查询
• 成本不透明：Runway Gen4等模型标注"varies"，缺乏固定定价

适合人群

• 需快速对比多模型效果的AI应用开发者
• 追求单一账单管理的中小团队
• 需要图像后处理工具链（去背、修复、扩图）的内容创作者
• 积分预算敏感、希望精细控制生成成本的用户

常规风险

| 风险类型 | 说明 |

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

| 密钥泄露 | API Key需环境变量管理，硬编码存在被盗刷积分风险 |

| 服务中断 | 聚合层故障将导致所有模型不可用，建议保留官方API兜底方案 |

| 内容安全 | 生成内容需自行合规审核，平台可能因违规内容封禁账户 |

| 积分耗尽 | 402错误需及时充值，高消耗模型（如Sora 50+积分）易触发余额不足 |

核心用法

Yollomi AI API Skill 是一个多模型 AI 图像与视频生成服务的统一封装层，通过单一 REST API 端点调用 20+ 种图像模型和 15+ 种视频模型。用户只需配置 YOLLOMI_API_KEY 环境变量，即可使用 POST /api/v1/generate 端点生成内容，支持 Flux、Stable Diffusion、Kling、Google Veo 等主流模型，以及背景移除、人脸替换、图像修复等实用功能。模型通过 modelId 参数切换，计费按积分制（1-50+ credits 不等），响应返回图片 URL 数组或视频链接。

显著优点

• 统一接口设计：所有模型共享同一端点，降低集成复杂度，无需为不同模型维护多套代码
• 功能覆盖全面：支持文生图、图生图、图生视频、背景处理、超分修复等完整 AI 视觉工作流
• 安全实现优秀：零第三方依赖消除供应链风险，HTTPS 传输加密，120 秒超时控制，完善的 URL 协议白名单验证
• 成本透明可控：各模型明码标价积分，部分工具模型（如背景移除）免费，便于预算规划
• 轻量无侵入：仅 345 行代码，7 个文件，TypeScript 实现，对运行时环境要求极低

潜在缺点与局限性

• 来源可信度中等（T3）：由个人开发者维护，非企业级背书，长期维护稳定性存疑
• 功能裁剪：当前版本已禁用视频生成（文档标注为"暂时禁用"），仅图像功能可用
• 第三方依赖锁定：完全依赖 Yollomi 官方服务可用性，存在单点故障风险
• 网络限制：仅支持 yollomi.com 域名，无法自建或切换至其他后端
• 积分消耗较高：专业模型如 Flux-2-Pro 达 15 积分/张，视频模型最高 50+ 积分，高频使用成本显著
• 无重试与缓存机制：当前实现缺少网络波动时的自动重试，也不支持结果缓存优化

适合人群

• 需要快速集成多模型 AI 图像生成的开发者
• 原型验证、内容创作自动化、电商图像处理等场景
• 已拥有 Yollomi 账户且熟悉 REST API 调用的技术用户
• 对供应链安全敏感、希望避免 npm 依赖膨胀的极简主义者

常规风险

• API 密钥泄露：需妥善保管 YOLLOMI_API_KEY，避免提交至版本控制
• 服务可用性：依赖 Yollomi Inc. 商业服务，存在停机、涨价或停止运营风险
• 内容合规：AI 生成内容可能涉及版权、肖像权及平台政策限制，需自行合规审查
• 积分耗尽：401/402 错误提示需检查密钥有效性与账户余额
• 网络超时：大模型生成或高峰期可能出现 120 秒超时，需用户端配合重试策略
• 隐私传输：图像数据上传至 Yollomi 服务器处理，敏感图像需谨慎评估

安全评估

CLS-Certify v2.1.0 扫描评分 87 分（A 级），静态分析 92 分、动态行为 85 分、依赖审计满分。关键结论：无危险函数、无硬编码密钥、无恶意模式，输入验证与 HTTPS 传输合规。主要关注点为外部 API 依赖风险（RISK-001），已通过超时控制缓解。