SaaS 与工作流接入
为自己的后端或工作流接入 i2v.ai 生成 API,实现任务归属、美元预算和签名回调。
选择入口
- 在 AI 助手中生成素材,参见 MCP 客户端指南。
- 批量处理本地文件或编写终端脚本,使用 CLI。
- 为自己的用户提供生成功能,请从 REST 快速开始开始。仓库提供 Node.js、Python、curl、Next.js 和 n8n 示例。也可以用
i2v-integrateSkill,让编程助手按你的项目结构接入和测试。
为每次操作保存一条记录
API Key 放在服务端。报价、创建、取消和查询任务前,检查应用用户是否有权操作对应租户。保存租户、稳定的幂等键、批准的美元额度、报价版本和提交时的完整入参。在同一记录保存受理后返回的任务 ID。
媒体接入指南包含签名上传和提交回执恢复。等待超时时,使用原任务 ID 或幂等键查询处理结果。任务成功后核对归属。如果结果需长期访问,请将文件保存到自己的存储。
接收签名回调
解析前对原始请求体进行验签。根据 X-I2V-Key-ID 选择密钥,校验时间戳和签名,存储已处理的事件 ID。重复或过时回调到达后,保留任务已有的终态。回调延迟时可以轮询。有完整字段和签名示例。
查看费用和可用额度
按真实输入报价,确认后提交美元上限。等待超时时,向用户返回可继续查询的原任务 ID。说明可用与预留余额,GET /api/v1/account/usage 用于查询已结算消耗和退款。任务费用计入所使用 API Key 所属的 i2v.ai 账户。

