""" Unified OpenAI-compatible LLM client for the Media Engine, with retry support. """ import os import sys from datetime import datetime from typing import Any, Dict, Optional, Generator from loguru import logger from openai import OpenAI # Ensure project-level retry helper is importable current_dir = os.path.dirname(os.path.abspath(__file__)) project_root = os.path.dirname(os.path.dirname(current_dir)) utils_dir = os.path.join(project_root, "utils") if utils_dir not in sys.path: sys.path.append(utils_dir) try: from retry_helper import with_retry, LLM_RETRY_CONFIG except ImportError: def with_retry(config=None): def decorator(func): return func return decorator LLM_RETRY_CONFIG = None class LLMClient: """ Minimal wrapper around the OpenAI-compatible chat completion API. """ def __init__(self, api_key: str, model_name: str, base_url: Optional[str] = None): if not api_key: raise ValueError("Media Engine LLM API key is required.") if not model_name: raise ValueError("Media Engine model name is required.") self.api_key = api_key self.base_url = base_url self.model_name = model_name self.provider = model_name timeout_fallback = os.getenv("LLM_REQUEST_TIMEOUT") or os.getenv("MEDIA_ENGINE_REQUEST_TIMEOUT") or "1800" try: self.timeout = float(timeout_fallback) except ValueError: self.timeout = 1800.0 client_kwargs: Dict[str, Any] = { "api_key": api_key, "max_retries": 0, } if base_url: client_kwargs["base_url"] = base_url self.client = OpenAI(**client_kwargs) @with_retry(LLM_RETRY_CONFIG) def invoke(self, system_prompt: str, user_prompt: str, **kwargs) -> str: current_time = datetime.now().strftime("%Y年%m月%d日%H时%M分") time_prefix = f"今天的实际时间是{current_time}" if user_prompt: user_prompt = f"{time_prefix}\n{user_prompt}" else: user_prompt = time_prefix messages = [ {"role": "system", "content": system_prompt}, {"role": "user", "content": user_prompt}, ] allowed_keys = {"temperature", "top_p", "presence_penalty", "frequency_penalty", "stream"} extra_params = {key: value for key, value in kwargs.items() if key in allowed_keys and value is not None} timeout = kwargs.pop("timeout", self.timeout) response = self.client.chat.completions.create( model=self.model_name, messages=messages, timeout=timeout, **extra_params, ) if response.choices and response.choices[0].message: return self.validate_response(response.choices[0].message.content) return "" def stream_invoke(self, system_prompt: str, user_prompt: str, **kwargs) -> Generator[str, None, None]: """ 流式调用LLM,逐步返回响应内容 Args: system_prompt: 系统提示词 user_prompt: 用户提示词 **kwargs: 额外参数(temperature, top_p等) Yields: 响应文本块(str) """ current_time = datetime.now().strftime("%Y年%m月%d日%H时%M分") time_prefix = f"今天的实际时间是{current_time}" if user_prompt: user_prompt = f"{time_prefix}\n{user_prompt}" else: user_prompt = time_prefix messages = [ {"role": "system", "content": system_prompt}, {"role": "user", "content": user_prompt}, ] allowed_keys = {"temperature", "top_p", "presence_penalty", "frequency_penalty"} extra_params = {key: value for key, value in kwargs.items() if key in allowed_keys and value is not None} # 强制使用流式 extra_params["stream"] = True timeout = kwargs.pop("timeout", self.timeout) try: stream = self.client.chat.completions.create( model=self.model_name, messages=messages, timeout=timeout, **extra_params, ) for chunk in stream: if chunk.choices and len(chunk.choices) > 0: delta = chunk.choices[0].delta if delta and delta.content: yield delta.content except Exception as e: logger.error(f"流式请求失败: {str(e)}") raise e @with_retry(LLM_RETRY_CONFIG) def stream_invoke_to_string(self, system_prompt: str, user_prompt: str, **kwargs) -> str: """ 流式调用LLM并安全地拼接为完整字符串(避免UTF-8多字节字符截断) Args: system_prompt: 系统提示词 user_prompt: 用户提示词 **kwargs: 额外参数(temperature, top_p等) Returns: 完整的响应字符串 """ # 以字节形式收集所有块 byte_chunks = [] for chunk in self.stream_invoke(system_prompt, user_prompt, **kwargs): byte_chunks.append(chunk.encode('utf-8')) # 拼接所有字节,然后一次性解码 if byte_chunks: return b''.join(byte_chunks).decode('utf-8', errors='replace') return "" @staticmethod def validate_response(response: Optional[str]) -> str: if response is None: return "" return response.strip() def get_model_info(self) -> Dict[str, Any]: return { "provider": self.provider, "model": self.model_name, "api_base": self.base_url or "default", }