init: api-gateway v2.4.0(Agnes/b.ai/火山方舟 三家供应商网关)

This commit is contained in:
api-gateway committed 2026-09-15 17:05:46 +08:00
commit 6cc65ff76f
91 files changed
+24653

No files matched your search

+191
View File
@@ -0,0 +1,191 @@
"""适配器基类:定义统一的 chat / 流式 / 图像 / 视频接口。"""
from __future__ import annotations
import asyncio
import json
from abc import ABC, abstractmethod
from contextlib import asynccontextmanager
from typing import Any, AsyncIterator
import httpx
from app.config import MediaConfig
class UpstreamResponseError(RuntimeError):
"""上游返回了"协议外"的响应(HTTP 200 但不是 JSON / body 为空)。
第六轮: 此前这类响应直接在 `resp.json()` 处抛 json.JSONDecodeError,
错误信息是 `Expecting value: line 1 column 1 (char 0)` —— 与真正的上游 5xx
无法区分,排查时极具误导性。
"""
def json_or_raise(resp) -> dict:
"""解析上游 JSON;失败时抛带 HTTP 状态与响应片段的 UpstreamResponseError。"""
try:
data = resp.json()
except (ValueError, json.JSONDecodeError) as e:
snippet = (resp.text or "")[:200]
raise UpstreamResponseError(
f"上游返回非 JSON 响应(HTTP {resp.status_code}): {snippet!r}") from e
if not isinstance(data, dict):
raise UpstreamResponseError(
f"上游返回了非预期的 JSON 类型({type(data).__name__}),HTTP {resp.status_code}")
return data
class BaseAdapter(ABC):
"""所有供应商适配器必须实现此接口。"""
def __init__(self, name: str, base_url: str, timeout: int = 120, media: MediaConfig | None = None):
self.name = name
self.base_url = base_url.rstrip("/")
self.timeout = timeout
self.media = media or MediaConfig()
self._client: httpx.AsyncClient | None = None
self._client_lock = asyncio.Lock() # Bug 1: 防并发竞态建多个 client
self._closing = False # 正在物理关闭连接
self._close_requested = False # 收到关闭请求,但仍有在途请求,等待排空后再关
self._active = 0 # 在途请求/流占用数(Bug 4: 热重载不打断在途请求)
async def get_client(self) -> httpx.AsyncClient:
"""获取共享 client 并占用一次(并发安全)。
之前:两个 coroutine 同时 if self._client is None 各建一个 → 泄漏。
现在:用 asyncio.Lock 保证只建一次,并 +1 占用计数(每次在途请求/流占用一次)。
"""
async with self._client_lock:
if self._client is None or self._closing:
self._closing = False
self._client = httpx.AsyncClient(
base_url=self.base_url,
timeout=httpx.Timeout(self.timeout),
)
self._active += 1
return self._client
async def _release(self) -> None:
"""归还一次占用。最后一次归还且曾收到关闭请求时,才真正关闭连接池。
Bug 4 修复: 让 close() 能感知『仍有请求在用』而延迟真正的网络关闭,
避免热重载关闭 client 时打断正在流式/在途的请求。
"""
async with self._client_lock:
self._active = max(0, self._active - 1)
if self._active == 0 and self._close_requested and self._client is not None:
self._closing = True
try:
await self._client.aclose()
except Exception:
pass
self._client = None
self._closing = False
self._close_requested = False
@asynccontextmanager
async def _lease(self) -> AsyncIterator[httpx.AsyncClient]:
"""async context manager:占用 client 执行一次网络操作,结束自动归还占用。"""
client = await self.get_client()
try:
yield client
finally:
await self._release()
async def _close_now_locked(self) -> None:
"""物理关闭连接池。**调用方必须已持有 _client_lock。**
第六轮并发审计实测的竞态:`close()` 先在锁内判定 `_active == 0`,出锁后再调
`_close_now()` 重新抢锁 —— 两步之间排队的 `get_client()` 可能先拿到锁、把
`_active` 加到 1 并返回该 client,随后它被 aclose() 掉,在途请求直接
`RuntimeError: Cannot send a request, as the client has been closed.`
现在把"判定 + 关闭"合并到同一次持锁内完成。
"""
if self._client is not None:
self._closing = True
try:
await self._client.aclose()
except Exception:
pass
self._client = None
self._closing = False
self._close_requested = False
async def close(self) -> None:
"""关闭 client(幂等可重入)。
之前:并发两次 close → 第二次对已关闭 client 抛 RuntimeError。
现在:有在途请求时置 _close_requested 等待排空(由最后一次 _release 关闭);
无在途请求则立即关闭。重复调用安全。
"""
async with self._client_lock:
if self._client is None and not self._close_requested:
return
if self._active > 0:
self._close_requested = True # 等在途请求排空后由最后一次 _release 关闭
return
# 第六轮: 置位 + 关闭都在同一次持锁内完成(见 _close_now_locked 的说明)
self._close_requested = True
await self._close_now_locked()
@abstractmethod
async def chat(
self,
model: str,
messages: list[dict],
temperature: float | None = None,
top_p: float | None = None,
max_tokens: int | None = None,
stream: bool = False,
stop: str | list[str] | None = None,
tools: list[dict] | None = None,
tool_choice: str | dict | None = None,
extra: dict[str, Any] | None = None,
) -> dict[str, Any]:
"""非流式 chat completion,返回统一格式的 dict。"""
...
@abstractmethod
async def chat_stream(
self,
model: str,
messages: list[dict],
temperature: float | None = None,
top_p: float | None = None,
max_tokens: int | None = None,
stop: str | list[str] | None = None,
tools: list[dict] | None = None,
tool_choice: str | dict | None = None,
extra: dict[str, Any] | None = None,
) -> AsyncIterator[dict]:
"""流式 chat completion,逐块 yield。"""
...
# ── 图像 / 视频(可选实现,默认不支持) ──────────
async def generate_image(
self,
model: str,
prompt: str,
size: str | None = None,
ratio: str | None = None,
image: list[str] | None = None,
n: int = 1,
extra: dict[str, Any] | None = None,
) -> dict[str, Any]:
raise NotImplementedError(f"供应商 {self.name} 不支持图像生成")
async def create_video(
self,
model: str,
prompt: str,
seconds: str = "5",
mode: str = "text",
aspect_ratio: str = "16:9",
size: str = "720P",
extra: dict[str, Any] | None = None,
) -> dict[str, Any]:
raise NotImplementedError(f"供应商 {self.name} 不支持视频创建")
async def poll_video(self, video_id: str, model: str = "", extra: dict[str, Any] | None = None) -> dict[str, Any]:
raise NotImplementedError(f"供应商 {self.name} 不支持视频查询")