身份验证
使用账户 API 密钥验证请求。
Bearer 鉴权
在账户页面创建和管理密钥。提交任务、查询结果、读取账户时,均携带以下请求头。
Authorization: Bearer YOUR_API_KEY按来源 IP 限制 API Key
创建或编辑密钥时可设置 IP 白名单。每行填写一个调用方的公网 IPv4、IPv6 或 CIDR 网段,最多 10 条。留空允许所有来源。来源不匹配或无法验证时,API 返回 HTTP 403。使用该密钥的 Playground 和 MCP 请求同样受限。
查看账户余额
curl "https://api.i2v.ai/api/v1/account" \
-H "Authorization: Bearer $I2V_API_KEY"响应包含 userId、email、name、balance、reserved、funding 和 createdAt。balance 和 reserved 为 USD 金额对象,amount 是八位小数字符串。funding 按资金类型提供可用与预留金额。时间戳单位为 Unix 毫秒。账户响应采用 Cache-Control: no-store。
处理鉴权错误
HTTP 401 表示密钥缺失、无效、过期或已撤销。更新有效密钥后再重试。任务查询仅返回当前账户拥有的任务。
将密钥保存在服务端环境变量中。密钥泄露后应通过账户撤销。MCP 客户端授权见 。

