# SaaS 与工作流接入

## 选择入口

- 在 AI 助手中生成素材，参见 [MCP 客户端指南](/docs/mcp)。
- 批量处理本地文件或编写终端脚本，使用 [CLI](/cli)。
- 为自己的用户提供生成功能，请从 [REST 快速开始](/docs)开始。仓库提供 [Node.js、Python、curl、Next.js 和 n8n 示例](https://github.com/i2v-ai/i2v-api-examples)。也可以用 `i2v-integrate` Skill，让编程助手按你的项目结构接入和测试。

## 为每次操作保存一条记录

API Key 放在服务端。报价、创建、取消和查询任务前，检查应用用户是否有权操作对应租户。保存租户、稳定的幂等键、批准的美元额度、报价版本和提交时的完整入参。在同一记录保存受理后返回的任务 ID。

[媒体接入指南](/docs/media-workflow)包含签名上传和提交回执恢复。等待超时时，使用原任务 ID 或幂等键查询处理结果。任务成功后核对归属。如果结果需长期访问，请将文件保存到自己的存储。

## 接收签名回调

解析前对原始请求体进行验签。根据 `X-I2V-Key-ID` 选择密钥，校验时间戳和签名，存储已处理的事件 ID。重复或过时回调到达后，保留任务已有的终态。回调延迟时可以轮询。[签名回调文档](/docs/webhooks)有完整字段和签名示例。

## 查看费用和可用额度

按真实输入报价，确认后提交美元上限。等待超时时，向用户返回可继续查询的原任务 ID。[API 参考](/docs/api)说明可用与预留余额，`GET /api/v1/account/usage` 用于查询已结算消耗和退款。任务费用计入所使用 API Key 所属的 i2v.ai 账户。