核心用法
SeisoAI 是一个聚合型 AI 内容生成网关，通过标准化 API 接入 120 余种生成工具，涵盖图像、视频、音频、3D 模型、音乐及 LoRA 训练等全品类。采用 x402 支付协议 实现按请求付费，所有交易以 USDC 在 Base 链上结算。
调用流程：
1. 发现工具：通过 /api/gateway/tools 查询可用工具及价格
2. 发起请求：POST 至 /invoke/{toolId}，预期返回 HTTP 402 支付挑战
3. 解析支付：提取 maxAmountRequired（需除以 1,000,000 换算为美元）、收款地址及网络信息
4. 用户授权：必须显式获得用户批准，展示工具名称、费用、币种及收款方
5. 签名重试：使用 x402-sign.mjs 脚本签署支付，携带 payment-signature 头重试请求
6. 结果获取：同步模式直接返回结果；队列模式需轮询 /jobs/{jobId}
定价区间：
- 图像：$0.016–$0.33/张（Flux 2 Klein 最便宜）
- 视频：$0.09–$0.26/秒（Wan 2.6 最便宜，Sora 2 Pro 最贵）
- 音频/TTS：$0.03–$0.05/次
- 3D 生成：$0.04–$0.16/次
- 训练：$0.004–$0.007/步
显著优点
- 工具覆盖极广：120+ 工具覆盖主流闭源与开源模型，包括 Veo 3、Sora 2、Kling、Flux、Hunyuan、Wan 等最新模型
- 即时接入：无需单独注册各平台账号，统一 API 即可调用多服务商资源
- 灵活计费：按次付费，无订阅门槛，适合低频或实验性使用场景
- 链上透明：x402 协议基于区块链结算，支付与执行状态可链上验证
- 高级功能支持：含视频换脸、唇形同步、360° 图像、深度估计、智能拓扑等专业工具
潜在缺点与局限性
- 加密支付门槛：必须持有 USDC 并配置 Base 网络钱包，对非 Web3 用户构成障碍
- 私钥管理风险：
SEISOAI_WALLET_KEY需以明文环境变量配置，存在泄露风险 - 支付摩擦：每次请求需两次 HTTP 往返（402 挑战 + 签名重试），延迟较高
- 一次性签名：签名不可复用，重复请求需重新支付
- 队列等待：视频/复杂任务可能进入异步队列，需客户端轮询
- 汇率与 Gas 波动：链上结算受网络拥堵影响，实际成本可能浮动
- 依赖外部节点：需 Node.js 运行签名脚本，增加部署复杂度
适合人群
- 开发者/创作者：需要快速实验多种 AI 模型，不愿分别对接各平台 API
- Web3 原生用户：已持有 USDC 并熟悉钱包操作，追求透明计费
- 轻量级商业项目：生成需求不规律，希望避免固定订阅成本
- AI 工作流集成者：需将多模态生成嵌入自动化管道（配合脚本可实现）
常规风险
| 风险类型 | 描述 | 缓解建议 |
|---------|------|---------|
| **私钥泄露** | `SEISOAI_WALLET_KEY` 为 0x 前缀私钥，泄露即资金损失 | 使用专用热钱包，限制余额，考虑硬件签名方案 |
| **合约风险** | 收款合约 `0xa0aE05e2766A069923B2a51011F270aCadFf023a` 若为恶意或遭攻击 | 小额测试，监控链上异常 |
| **价格误导** | `maxAmountRequired` 为最大扣费，实际可能低于预期 | 确认价格端点返回值，保留支付记录 |
| **服务可用性** | 依赖 SeisoAI 网关及 Base 网络稳定性 | 实现 429/500 重退避逻辑 |
| **内容合规** | 生成内容可能涉及版权、肖像权或有害信息 | 遵守各模型使用条款，启用 `vision.nsfw-detect` 预检 |
| **签名重放** | 服务端需确保 nonce 机制防止签名复用攻击 | 依赖协议实现，客户端无法干预 |
技术实现注意事项
- 请求体在 402 挑战与付费重试时必须完全一致，否则验签失败
PAYMENT-REQUIRED响应头含 base64 编码的支付载荷，可作为备选解析源- 错误码 402 + "already used" 表示签名已被消费，需重新获取挑战并签名
- 支持
web_search、code_execution等 Claude API 高级功能，但需单独配置 Anthropic 凭证