"""商业化预留 v1 API:API Key 认证 + 限流 + 用量账本。 设计原则: - /v1/* 稳定契约:只加字段不改语义,向前兼容 - key 只存 sha256;明文只返回一次 - scope 分级:chat / full;rate_limit 按 key 限流 - 用量落 usage_logs,将来接计费系统零改造 """ import hashlib import secrets import time import datetime as dt from collections import defaultdict, deque from fastapi import APIRouter, Depends, HTTPException, Request from pydantic import BaseModel from sqlalchemy import select from ..db.session import get_db from ..db import repos from ..models.entities import ApiKey, UsageLog, User, Message from ..api.routers.auth import current_user from ..api.routers.chat import (_dec, _enc, _own_session, _key, build_context, _channel_for) router = APIRouter(prefix="/v1", tags=["v1-commercial"]) # ---------- API Key 认证 ---------- def _hash_key(raw: str) -> str: return hashlib.sha256(raw.encode()).hexdigest() async def api_key_auth(request: Request, db=Depends(get_db)) -> tuple[User, ApiKey]: raw = request.headers.get("X-API-Key", "") if not raw: raise HTTPException(401, "缺少 X-API-Key") row = (await db.execute(select(ApiKey).where( ApiKey.key_hash == _hash_key(raw), ApiKey.revoked == False))).scalar_one_or_none() if not row: raise HTTPException(401, "API Key 无效或已吊销") user = await db.get(User, row.user_id) if not user or not user.is_active: raise HTTPException(401, "账户无效") return user, row # ---------- 限流(滑动窗口,进程内;多实例部署换 Redis) ---------- _buckets: dict[int, deque] = defaultdict(deque) def check_rate_limit(key_row: ApiKey): b = _buckets[key_row.id] now = time.time() while b and b[0] < now - 60: b.popleft() if len(b) >= key_row.rate_limit: raise HTTPException(429, f"超过限流 {key_row.rate_limit}/min") b.append(now) async def log_usage(db, user: User, key_row: ApiKey, endpoint: str): db.add(UsageLog(user_id=user.id, api_key_id=key_row.id, endpoint=endpoint, cost_units=1)) key_row.last_used_at = dt.datetime.utcnow() await db.commit() # ---------- Key 管理(JWT 鉴权) ---------- class KeyIn(BaseModel): name: str = "default" scope: str = "chat" # chat / full rate_limit: int = 60 @router.post("/keys") async def create_key(body: KeyIn, user: User = Depends(current_user), db=Depends(get_db)): raw = "omk_" + secrets.token_urlsafe(24) row = ApiKey(user_id=user.id, key_hash=_hash_key(raw), name=body.name, scope=body.scope, rate_limit=body.rate_limit) db.add(row) await db.commit() return {"key": raw, "id": row.id, "notice": "明文仅此一次,请立即保存"} @router.get("/keys") async def list_keys(user: User = Depends(current_user), db=Depends(get_db)): rows = (await db.execute(select(ApiKey).where( ApiKey.user_id == user.id, ApiKey.revoked == False))).scalars().all() return {"keys": [{"id": k.id, "name": k.name, "scope": k.scope, "rate_limit": k.rate_limit, "last_used": str(k.last_used_at or "")} for k in rows]} @router.delete("/keys/{kid}") async def revoke_key(kid: int, user: User = Depends(current_user), db=Depends(get_db)): row = await db.get(ApiKey, kid) if not row or row.user_id != user.id: raise HTTPException(404, "不存在") row.revoked = True await db.commit() return {"ok": True} @router.get("/usage") async def my_usage(user: User = Depends(current_user), db=Depends(get_db)): rows = (await db.execute(select(UsageLog).where( UsageLog.user_id == user.id).order_by(UsageLog.id.desc()).limit(500))).scalars().all() by_ep = {} for r in rows: by_ep[r.endpoint] = by_ep.get(r.endpoint, 0) + 1 return {"recent_calls": len(rows), "by_endpoint": by_ep} # ---------- v1 稳定接口 ---------- @router.get("/ping") async def ping(): """健康检查,无鉴权""" return {"ok": True, "service": "open-maopaoya", "version": "v1"} @router.get("/characters") async def v1_characters(pair: tuple = Depends(api_key_auth), db=Depends(get_db)): user, key_row = pair if key_row.scope != "full": raise HTTPException(403, "scope 不足,需要 full") from ..db.repos import dec rows = await repos.CharacterRepo.list_for(db, user.id) await log_usage(db, user, key_row, "/v1/characters") k = _key(user) return {"data": [{"id": c.id, "name": c.name, "persona": dec(k, c.persona), "voice": c.voice} for c in rows]} class V1ChatIn(BaseModel): session_id: int content: str @router.post("/chat") async def v1_chat(body: V1ChatIn, pair: tuple = Depends(api_key_auth), db=Depends(get_db)): """以 API Key 驱动一次对话(走用户自己的渠道配置)""" user, key_row = pair check_rate_limit(key_row) s = await _own_session(db, user, body.session_id) db.add(Message(session_id=s.id, user_id=user.id, role="user", content_enc=_enc(user, body.content))) await db.commit() history = await repos.MessageRepo.history(db, user.id, s.id, limit=80) msgs = await build_context(db, user, s, history) client, models = await _channel_for(db, user, s) reply = await client.chat(models.get("narrative") or "step-3.5-flash", msgs) db.add(Message(session_id=s.id, user_id=user.id, role="assistant", content_enc=_enc(user, reply))) await log_usage(db, user, key_row, "/v1/chat") await db.commit() return {"reply": reply, "session_id": s.id}