账户 (Accounts)
所有端点需要 Bearer Token 认证。
创建账户(工作区)
POST /v1/accounts请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
slug | string | 是 | 唯一标识符(URL 友好) |
name | string | 是 | 显示名称 |
响应
{
"id": "...",
"slug": "acme-corp",
"name": "Acme Corp",
"type": "workspace",
"created_at": "2024-01-01T00:00:00Z"
}获取当前用户的账户列表
GET /v1/accounts/me获取账户详情
GET /v1/accounts/{account_id}获取账户用量(月度)
GET /v1/accounts/{account_id}/usage查询参数同 GET /v1/me/usage。
获取账户用量(按日)
GET /v1/accounts/{account_id}/usage/daily获取账户用量(按模型)
GET /v1/accounts/{account_id}/usage/by-model团队管理
创建团队
POST /v1/teams请求体
| 字段 | 类型 | 必填 |
|---|---|---|
name | string | 是 |
响应
{
"id": "...",
"account_id": "...",
"name": "法务团队",
"members_count": 0,
"created_at": "2024-01-01T00:00:00Z"
}列出团队
GET /v1/teams删除团队
DELETE /v1/teams/{team_id}列出团队成员
GET /v1/teams/{team_id}/members响应
[
{
"team_id": "...",
"user_id": "...",
"role": "member",
"created_at": "2024-01-01T00:00:00Z"
}
]添加团队成员
POST /v1/teams/{team_id}/members请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
user_id | string | 是 | |
role | string | 是 | member 或 admin |
移除团队成员
DELETE /v1/teams/{team_id}/members/{user_id}邀请管理
发送邀请
POST /v1/accounts/{account_id}/invitations请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
email | string | 是 | 受邀邮箱 |
role | string | 是 | 分配角色 |
响应
{
"id": "...",
"account_id": "...",
"invited_by_user_id": "...",
"email": "bob@example.com",
"role": "member",
"expires_at": "2024-02-01T00:00:00Z",
"accepted_at": null,
"created_at": "2024-01-01T00:00:00Z",
"token": "..."
}列出邀请
GET /v1/accounts/{account_id}/invitations接受邀请
POST /v1/account-invitations/{token}/accept响应
{ "ok": true }撤销邀请
DELETE /v1/account-invitations/{invitation_id}