API Key 与导出
管理 API Key
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /management/keys?workspace_id= | 列出 Key（status / key_type / q 过滤，cursor 分页） |
POST | /management/keys | 创建 personal Key，明文仅返回一次 |
GET | /management/keys/{id}?workspace_id= | 详情（掩码） |
PATCH | /management/keys/{id}?workspace_id= | 改名 / 到期时间 / 消费上限三态 |
POST | /management/keys/{id}/disable | 禁用 |
POST | /management/keys/{id}/enable | 启用 |
POST | /management/keys/{id}/rotate | 轮换，返回新明文 |
POST | /management/keys/{id}/rotate/confirm | 确认轮换 |
DELETE | /management/keys/{id}?workspace_id= | 撤销（保留 revoked 状态） |
- 创建/修改/删除/轮换必须带
Idempotency-Key。 - 明文只在创建或轮换响应中返回一次，列表与详情只返回掩码。
- 只支持
key_type=personal；越权访问统一折叠为404。 - Key 立即生效：禁用/撤销后网关马上拒绝。
导出
| 方法 | 路径 | 说明 | |||
|---|---|---|---|---|---|
POST | /management/exports | 创建任务（`kind=usage | cost | generations，format=csv | json`） |
GET | /management/exports | 列出任务 | |||
GET | /management/exports/{id} | 任务状态 | |||
GET | /management/exports/{id}/download | 下载产物（未完成返回 409） |
- 创建需要
Idempotency-Key；同一任务最多导出一页，next_cursor指向下一页。 - 产物 24 小时后过期，过期或不存在统一返回
404。 - 导出内容与同权限的在线查询一致。
usage/generations导出与在线字段同源：JSON 含media_units；CSV 末尾追加媒体列（image_count/video_seconds/audio_seconds，generations另加reasoning_tokens），未发生的类型留空。