# 身份验证

## Bearer 鉴权

在[账户页面](/me?section=api-keys)创建和管理密钥。提交任务、查询结果、读取账户时，均携带以下请求头。

```http
Authorization: Bearer YOUR_API_KEY
```

## 按来源 IP 限制 API Key

创建或编辑密钥时可设置 IP 白名单。每行填写一个调用方的公网 IPv4、IPv6 或 CIDR 网段，最多 10 条。留空允许所有来源。来源不匹配或无法验证时，API 返回 HTTP `403`。使用该密钥的 Playground 和 MCP 请求同样受限。

## 查看账户余额

```bash
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 客户端授权见 [MCP 接入](/docs/mcp)。