鉴权

估值、OCR、钱包等开放接口任选其一：

X-Api-Key: aai_xxxxxxxx

Authorization: Bearer aai_xxxxxxxx

若在控制台为 Key 配置了 IP 白名单，请求来源 IP 必须匹配，否则返回 40300。

开放认证无需滑块。网页控制台仍走 /api/v1/auth/**（需要滑块），与开放登录不是同一条路径。

试用开户（不必先有手机号）

与网页同一套账号。Skill / MCP 默认走这条：随机账号密码注册，再用登录 JWT 创建 Key。

POST /api/open/v1/auth/register
Content-Type: application/json

{ "account": "your_login_name", "password": "********", "confirmPassword": "********" }

成功 data：accessToken、tokenType、expiresIn、user。账号冲突返回 40900。

再用 JWT 创建 Key（不要用 aai_ 调这个接口）：

POST /api/open/v1/auth/api-keys
Authorization: Bearer <accessToken>
Content-Type: application/json

{ "name": "Skill" }

name 可空，默认 Agent。data.apiKey 完整密钥只返回一次。

已有账号登录

主路径是短信验证码，仍有发送频控与 IP 限流。

POST /api/open/v1/auth/verification-codes
Content-Type: application/json

{ "account": "13800000000" }

purpose 可省略，默认 LOGIN。账号不存在时发码仍返回统一成功文案，不会真正发短信（避免枚举账号）。

POST /api/open/v1/auth/login
Content-Type: application/json

{ "account": "13800000000", "verificationCode": "123456" }

成功后再用 JWT 调 POST /api/open/v1/auth/api-keys。

备用密码登录：POST /api/open/v1/auth/login/password，Body { "account", "password" }。

Skill CLI：send-code --account → 用户提供短信码 → login --account --code。
MCP：send_login_code → login_asset_ai → create_api_key。

绑定手机

试用额度用尽后，估值或充值返回 40201，须先绑手机。

1. 发码：POST /api/open/v1/auth/verification-codes，Body { "account": "13800000000", "purpose": "BIND" }（无需 Key）。
2. 绑定：POST /api/open/v1/auth/bind-phone，Header 带当前试用 Key，Body { "account", "verificationCode" }。

手机未注册则升级当前试用账号；已注册则切换到该账号（试用额度不转入）。切换时 data.apiKey 可能返回新密钥，只此一次。

详情链接免登

估值成功后的详情页可带短期免登参数，用户点击即可打开，不必再登录。

POST /api/open/v1/auth/sso
X-Api-Key: aai_xxxxxxxx

data.code 拼到详情 URL 的查询参数 sso。凭证短期有效，过期后重新签发。网页如何消费该参数不在开放契约内。

JSON 响应

{ "code": 0, "message": "success", "data": { } }

字段	说明
code	0 成功；非 0 见 错误码
message	提示文案
data	业务数据；失败时可能为 null

SSE 流式接口直接返回 text/event-stream，不使用上述 JSON 包装。

创建与查询的 data 字段见 约定与通用响应。