核心用法
Yollomi AI API 是一个聚合型AI生成服务,通过单一 RESTful 端点 /api/v1/generate 提供图像生成、视频合成、背景移除、图像修复、人脸替换等20余种功能。开发者只需配置 YOLLOMI_API_KEY 环境变量,即可调用 Flux、Stable Diffusion 3.5、Kling、Google Veo、OpenAI Sora 等主流模型。
典型工作流:
1. 调用 GET /api/v1/models 获取可用模型与积分消耗
2. 根据场景选择模型(文生图/图生图/视频/编辑工具)
3. 构造请求体,type 字段区分 "image" 或 "video"
4. 处理响应中的 images 数组或 video URL
显著优点:
- 统一接口设计:所有模型共享相同端点和认证方式,大幅降低多供应商集成成本
- 模型覆盖全面:涵盖文生图(Flux系列、Imagen 4、Ideogram)、视频生成(Kling、Veo、Sora、Runway)、图像编辑(去背景、超分、修复、虚拟试穿)三大类别
- 灵活的积分机制:低至1积分的极速模型(z-image-turbo),按需付费无订阅捆绑
- Aspect Ratio 标准化:统一支持 1:1、16:9、9:16 三种比例,减少参数碎片化
潜在缺点与局限性:
- 商业透明度不足:
yollomi.com域名背景、公司实体信息未披露,API 实际由哪家云服务商托管不明 - 积分定价波动:视频模型标注"varies"或"~50+",成本不可预测;部分模型按秒计费(kling-v2-6-motion-control: 7/sec)
- 依赖第三方模型:本质为模型聚合层,非自研基础设施,服务稳定性受制于上游供应商
- 速率限制与排队策略:文档未明确说明并发限制和超时重试机制
适合人群:
- 需快速原型验证的独立开发者/初创团队
- 不想维护多平台 API 密钥的中型应用
- 对图像编辑工具链(去背景、超分、修复)有批量需求的内容创作者
常规风险:
- API Key 泄露:Bearer Token 长期有效,建议配合密钥管理服务
- 内容合规:生成模型可能产出受版权保护风格或不当内容,需自行配置过滤策略
- 供应商锁定:统一端点虽简化调用,但迁移至原生供应商时需重构参数映射
- 积分耗尽导致服务中断:402 错误需前置监控,建议集成
remainingCredits响应值做预算告警