Eden AI统一API网关：多模型路由、计费与企业安全指南

Eden AI 是什么

Eden AI 是一家法国公司提供的统一 AI API 网关，帮助开发者通过一个账户、一组密钥和一套接口调用多个第三方 AI 供应商。它主要解决重复接入、账单分散、模型切换、故障回退和用量监控问题。

Eden AI 本身不是底层大模型提供商，而是技术中介与治理层。模型质量、可用性、数据处理和输出仍会受到所选供应商影响。

当前产品范围

当前 V3 文档写明可访问500多个模型和50多个供应商，覆盖通用语言模型与专家型 AI 能力。模型目录会不断更新，个别新集成页面使用更高数量口径，选型时应查询实时模型列表。

能力类别	典型输入	主要输出	适合场景
LLM聊天与视觉	消息、图片、工具定义和参数	文本、结构化结果或工具调用	助手、问答、内容和智能体
OCR与文档	图片、PDF和业务文档	文字、字段、表格和结构化数据	票据、合同、证件和表单处理
文本分析	文本或文档	分类、实体、关键词、摘要和审核结果	内容治理和信息抽取
图像与视频	提示词、图片或视频	生成、编辑、检测或分析结果	创意、视觉审核和媒体工作流
语音与音频	音频或文字	转写、合成语音和音频分析	会议、客服、字幕和语音应用
翻译	文字、语言与术语要求	目标语言文本	多语言产品和内容本地化

V3两类统一接口

V3 把主要能力组织为聊天接口与 Universal AI 接口。聊天接口兼容常见的 OpenAI Chat Completions 请求格式，专家模型接口则统一 OCR、文本、图像、音频和翻译等任务。

接口	用途	模型标识方式	主要特点
Chat Completions	聊天、生成、视觉、工具调用	供应商与模型组合	OpenAI兼容格式，可流式输出和设置回退
Universal AI	OCR、审核、翻译、图像和音频等	功能、子功能与供应商组合	统一输入输出并支持专家模型回退
Listing接口	发现模型、功能和输入结构	按类别查询	避免在代码中长期硬编码过时目录
文件接口	上传并复用文件	文件UUID	可跨请求引用，需确认存储设置与删除流程

所有请求使用 Bearer API key 认证。密钥应只保存在服务器端或受控密钥系统中，不能嵌入网页、移动应用包或公开仓库。

模型切换、智能路由与回退

开发者可以显式选择供应商和模型，也可以使用智能路由让 Eden AI 根据质量、成本、延迟和供应商健康状态选择模型。候选池可限制自动选择范围，避免路由到不符合内部政策的模型。

显式模型适合需要固定行为、测试基线和可重复性的场景。
智能路由适合在质量、成本和延迟之间动态平衡。
候选池可只允许已通过法务、安全和质量审查的模型。
Fallback 会在主模型失败、限流或不可用时依次尝试备用模型。
专家模型回退要求主供应商与备用供应商支持同一功能。
不同模型输出结构、内容政策和计费单位仍可能不同。

自动回退提高可用性，但可能改变语言风格、准确率、地区和成本。生产系统应记录最终使用的供应商、模型、费用和回退路径。

统一账单与成本监控

Eden AI 为不同供应商提供统一余额、发票和用量视图，每次 API 响应包含美元成本字段。团队可创建多个 API key，把测试、生产、客户或项目的费用分开。

模型目录展示供应商价格，并随供应商调整而更新。
响应成本字段有助于建立单请求、用户和功能的成本指标。
自动充值可在余额低于阈值时购买额度。
可设置月度自动充值上限，降低失控扣款风险。
底层供应商可能采用token、图片、分钟、页面或请求等不同单位。
缓存、重试和Fallback都可能改变实际费用，应在压测中计算。

开发接入流程

注册账户，在控制台创建用于开发环境的API key。
查询模型与功能目录，筛选能力、地区、价格和输入限制。
为聊天任务选择兼容接口，为OCR等任务选择Universal AI。
在服务器端配置基础地址和Bearer认证，不在客户端暴露密钥。
先用单个便宜模型发送最小请求，检查状态、输出和cost字段。
为响应超时、供应商错误、限流和余额不足分别编写处理逻辑。
添加经过测试的Fallback，并对回退后的质量与费用设阈值。
为生产、测试和不同客户创建独立密钥与预算监控。
根据数据分类设置允许的供应商、模型和处理地区。
上线前完成DPA、第三方供应商条款、日志与删除流程审查。

OpenAI兼容接入

聊天接口采用 OpenAI 兼容请求格式，已有工具通常可以通过替换基础地址、API key 和模型名称接入。兼容主要指调用形状相近，不保证每个供应商支持完全相同的参数、工具调用或流式行为。

先锁定客户端版本并运行最小聊天请求。
测试system消息、结构化输出、工具调用、图片和流式响应。
对不被某模型支持的参数设置降级或删除逻辑。
不要假设模型名称、上下文长度和价格永久不变。
记录网络请求错误与响应内部的供应商失败状态。
对关键结果实施模式验证、内容审核和人工复核。

价格与套餐

套餐或版本	价格	计费周期	核心权益或额度	适合用户
Self-serve AI API	供应商原价加5.5%平台费	按量消耗预付额度	500+模型、统一API与账单、多密钥、监控、自动充值、无限席位	开发者、初创团队和中等用量产品
Advanced AI Platform	定制报价	按合同	更高限速、批量折扣、私有部署、定制优化、SLA、专业服务和定制结算	大规模与受监管企业

自助版不对供应商单价加价，而是在购买额度结算时收取5.5%平台费；付款通过 Stripe 处理。不同模型的单价和计费单位随供应商变化，最终费用应以模型目录、响应 cost 字段和结算页为准。

条款说明服务可采用按量、预付或订阅方式，除非另有说明，付款通常不退款。启用自动充值前应设置阈值、月度上限和账单告警。

限速与容量

当前价格比较表对自助版写每秒10次请求，而同页详细说明写默认每秒7次、可申请提升至每秒15次。公开口径不完全一致，应以账户显示、技术支持或合同为准。

底层供应商可能设置比Eden AI账户更严格的独立限速。
并发、每分钟token、文件大小和异步任务限制可能按功能变化。
Fallback不能保证绕过所有供应商的共同容量问题。
企业版可协商更高限速和批量折扣。
压测应覆盖峰值、回退链、超时、重试和成本上限。

数据流与默认保留

Eden AI 的隐私政策与DPA表示，提示词、输出和客户内容默认不存储，只为路由请求进行瞬时处理，并保留计费、安全和运营所需的有限元数据。可选日志功能开启后会改变默认状态。

账户数据可包括姓名、邮箱、公司和结算信息。
使用元数据可包括时间、请求量、模型、token和费用。
客户数据可能包含文字、文件、图像、音频和模型输出。
默认零内容保留不等于所有元数据都立即删除。
文件复用功能需要持久化标识，使用前应确认具体保存与删除行为。
Eden AI称不出售客户数据，也不使用客户内容训练模型。

安全页将提示词、上传文件和输出描述为默认零保留，另有说明使用“24小时内丢弃”的操作口径。企业应在合同、DPA和实际配置中明确“零保留”的时间定义、例外和删除证据。

底层供应商仍需单独评估

Eden AI 会把请求发送给用户选择的第三方模型供应商，DPA也明确这些供应商可能作为子处理方处理数据。Eden AI网关的默认保留与安全承诺不会自动覆盖每个底层供应商的全部行为。

检查供应商是否保存提示词、输出或滥用监测日志。
确认数据处理地区与所需的跨境传输机制。
核对供应商是否使用数据改进或训练模型。
了解内容政策、版权条款和受限使用场景。
只在通过审查的候选池中启用智能路由和Fallback。
敏感数据进入模型前应做最小化、脱敏和访问控制。

安全、合规与治理

Eden AI 当前安全页标示 SOC 2 与 ISO 27001 认证，并提供GDPR相关文档和DPA。企业功能包括区域端点、供应商与模型控制、输入保护、输出审核、策略路由和集中可见性。

控制	作用	边界
EU区域端点	在支持条件下把工作负载路由至特定地区	供应商或模型不支持时应阻止或报错
零内容保留	默认不长期保存提示词、文件和输出	元数据、可选日志和底层供应商需另审
输入保护	在请求进入模型前检测敏感或违规内容	不能替代业务数据分类
输出审核	在结果返回应用前检测有害内容	不同语言和领域仍可能漏检
访问与密钥控制	分离项目、环境和团队权限	应用方仍需轮换密钥和最小权限
监控	观察用量、延迟、错误和成本	不要把敏感原文写入自有日志

条款、输出与责任

条款明确 Eden AI 不拥有或运营底层模型，也不控制其可用性、性能、输出或数据处理实践。客户需要遵守所选供应商的适用条款，并对自己的数据、应用和最终用途负责。

AI输出可能错误、不完整、有害或侵犯第三方权利。
医疗、法律、金融和安全决策不能只依赖模型输出。
客户必须具备处理与传输个人数据的合法基础。
产品服务许可不授予底层模型权重、训练数据或供应商源码。
模型切换可能改变输出权利和可接受使用范围。
高风险应用应建立人工审批、审计记录和撤回机制。

GitHub、SDK与开源状态

项目	状态	许可证或说明
Eden AI核心网关	专有托管服务	未公开核心平台源码许可证
edenai-skill	官方公开仓库	用于让编码智能体调用Eden AI，MIT
cookbook	官方公开示例	包含可运行配方，许可按仓库文件
docs	官方文档仓库	公开，当前标示MIT
pi-edenai	官方集成仓库	用于Pi的Eden AI provider，MIT
第三方SDK	社区提供	身份、维护和许可需逐个核验