核心功能
Seisoai 为 AI Agent 提供标准化的媒体生成基础设施，核心能力包括：
动态工具发现与调用：通过 /api/gateway/tools 实时获取可用工具列表，支持图像生成（Flux-2、Kling）、视频合成（Veo3、Kling-3）、3D 重建（Hunyuan）、语音克隆、音乐生成等全品类 AIGC 服务。
双模式认证体系：
- API Key 模式：适合高频固定场景，预付费信用额度
- x402 链上支付：基于 Base 链的 USDC 按次付费，无需预充值，适合弹性需求
智能任务调度：支持队列任务（queue）异步处理，提供状态轮询与结果回调机制；内置价格预查询（/price/{toolId}）避免意外扣费。
Agent 级安全管控：针对多 Agent 编排场景，强制实施「默认拒绝」策略，包含显式任务授权、精确 Agent 绑定、工具白名单校验、防递归编排、审计日志等 9 项安全控制。
显著优点
- 生态覆盖全：集成 Flux、Veo3、Kling、Hunyuan 等一线模型，单接口通吃文生图/视频/3D/音频
- 无门槛接入：x402 支付消除预付成本，小额开发者友好
- Agent 原生设计：动态发现避免硬编码工具列表，MCP 协议兼容
- 可靠性机制：明确的错误码策略（400/402/404/503/500）、退避重试、工具降级指引
局限性与风险
- 平台依赖：工具可用性受 Seisoai 上游供应商 SLA 制约，503 错误需人工切换备选方案
- x402 复杂度：链上支付需钱包签名、Gas 费管理，非 Web3 背景开发者有学习成本
- Agent 安全门槛：
agent/*路由的安全控制文档较长，实现不当易导致权限边界突破 - 队列任务延迟：高并发时段生成任务可能排队，实时性敏感场景需评估
适合人群
- 构建多模态 Agent 的开发者与产品团队
- 需要弹性计费、不愿预付大额 API 额度的创业项目
- Web3 原生应用，希望将生成成本与链上支付流整合
- 已有 MCP 协议栈，需快速扩展 AIGC 能力的工程团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 资金风险 | x402 签名一旦提交即链上结算，错误调用不可撤回；建议先 `/price` 询价 |
| 内容合规 | 生成内容由底层模型服务商审核，存在输出拦截或账号关联风险 |
| 数据隐私 | 图片/视频 URL 需可公网访问，敏感素材需预脱敏 |
| 供应商锁定 | 工具 ID 与 Seisoai 内部注册表强绑定，迁移需重新对接原生 API |