# Copyright 2026 zhaoxi826 # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. from fastapi import APIRouter, Depends from pydantic import BaseModel from typing import Literal from pretor.utils.access import TokenData, Accessor from pretor.utils.check_user.role_check import RoleChecker from pretor.core.database.table.user import UserAuthority from typing import Dict from pretor.core.global_state_machine.model_provider.base_provider import Provider from pretor.utils.ray_hook import ray_actor_hook provider_router = APIRouter(prefix="/api/v1/provider", tags=["provider"]) class ProviderRegister(BaseModel): """ProviderRegister 核心组件类。 这是一个模型/服务提供商适配器类,屏蔽了外部不同供应商(如 OpenAI、Anthropic 等)的底层 API 差异。它负责标准化参数组装、网络请求发送、鉴权处理以及响应结构的反序列化。""" provider_type: Literal["openai", "claude", "deepseek"] provider_title: str provider_url: str provider_apikey: str @provider_router.post("") async def create_provider( provider_register: ProviderRegister, token_data: TokenData = Depends(RoleChecker(allowed_roles=UserAuthority.USER)), ) -> None: """处理针对 create provider 相关的 HTTP API 请求。 该接口负责解析前端传入的载荷数据,调用底层核心业务逻辑进行处理,并组装标准化的 JSON 响应。 Args: provider_register (ProviderRegister): 目标对象的唯一全局标识符 (UUID/ULID),用于在数据库表或缓存结构中精准匹配该 provider_register 实例。 token_data (TokenData): 从客户端传递过来或由上游组件生成的核心业务数据体,通常需要进一步的清洗和结构化解析。 Returns: (None): 序列化后的标准网络响应模型(如包含业务状态码、成功标志及对应的数据载荷 Data)。""" global_state_machine = ray_actor_hook("global_state_machine").global_state_machine await global_state_machine.add_provider_wrap.remote( provider_type=provider_register.provider_type, provider_title=provider_register.provider_title, provider_url=provider_register.provider_url, provider_apikey=provider_register.provider_apikey, provider_owner=token_data.user_id, ) @provider_router.get("/list") async def get_provider_list( _: TokenData = Depends(Accessor.get_current_user), ) -> Dict[str, Dict[str, Provider]]: """处理针对 get provider list 相关的 HTTP API 请求。 该接口负责解析前端传入的载荷数据,调用底层核心业务逻辑进行处理,并组装标准化的 JSON 响应。 Args: _ (TokenData): 参与 get provider list 逻辑运算或数据构建的上下文依赖对象。 Returns: (Dict[str, Dict[str, Provider]]): 序列化后的标准网络响应模型(如包含业务状态码、成功标志及对应的数据载荷 Data)。""" global_state_machine = ray_actor_hook("global_state_machine").global_state_machine provider_list: Dict[ str, Provider ] = await global_state_machine.get_provider_list.remote() return {"provider_list": provider_list} @provider_router.delete("/{provider_title}") async def delete_provider( provider_title: str, _: TokenData = Depends( RoleChecker(allowed_roles=UserAuthority.SUPER_ADMINISTRATOR) ), ) -> dict: """处理针对 delete provider 相关的 HTTP API 请求。 该接口负责解析前端传入的载荷数据,调用底层核心业务逻辑进行处理,并组装标准化的 JSON 响应。 Args: provider_title (str): 目标对象的唯一全局标识符 (UUID/ULID),用于在数据库表或缓存结构中精准匹配该 provider_title 实例。 _ (TokenData): 参与 delete provider 逻辑运算或数据构建的上下文依赖对象。 Returns: (dict): 序列化后的标准网络响应模型(如包含业务状态码、成功标志及对应的数据载荷 Data)。""" global_state_machine = ray_actor_hook("global_state_machine").global_state_machine await global_state_machine.delete_provider.remote(provider_title=provider_title) return {"message": "success"}