openai.py 37 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112
  1. import asyncio
  2. import hashlib
  3. import json
  4. import logging
  5. from typing import Optional
  6. import aiohttp
  7. from aiocache import cached
  8. import requests
  9. from urllib.parse import quote
  10. from fastapi import Depends, HTTPException, Request, APIRouter
  11. from fastapi.responses import (
  12. FileResponse,
  13. StreamingResponse,
  14. JSONResponse,
  15. PlainTextResponse,
  16. )
  17. from pydantic import BaseModel
  18. from starlette.background import BackgroundTask
  19. from open_webui.models.models import Models
  20. from open_webui.config import (
  21. CACHE_DIR,
  22. )
  23. from open_webui.env import (
  24. MODELS_CACHE_TTL,
  25. AIOHTTP_CLIENT_SESSION_SSL,
  26. AIOHTTP_CLIENT_TIMEOUT,
  27. AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST,
  28. ENABLE_FORWARD_USER_INFO_HEADERS,
  29. BYPASS_MODEL_ACCESS_CONTROL,
  30. )
  31. from open_webui.models.users import UserModel
  32. from open_webui.constants import ERROR_MESSAGES
  33. from open_webui.env import SRC_LOG_LEVELS
  34. from open_webui.utils.payload import (
  35. apply_model_params_to_body_openai,
  36. apply_model_system_prompt_to_body,
  37. )
  38. from open_webui.utils.misc import (
  39. convert_logit_bias_input_to_json,
  40. )
  41. from open_webui.utils.auth import get_admin_user, get_verified_user
  42. from open_webui.utils.access_control import has_access
  43. log = logging.getLogger(__name__)
  44. log.setLevel(SRC_LOG_LEVELS["OPENAI"])
  45. ##########################################
  46. #
  47. # Utility functions
  48. #
  49. ##########################################
  50. async def send_get_request(url, key=None, user: UserModel = None):
  51. timeout = aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST)
  52. try:
  53. async with aiohttp.ClientSession(timeout=timeout, trust_env=True) as session:
  54. async with session.get(
  55. url,
  56. headers={
  57. **({"Authorization": f"Bearer {key}"} if key else {}),
  58. **(
  59. {
  60. "X-OpenWebUI-User-Name": quote(user.name, safe=" "),
  61. "X-OpenWebUI-User-Id": user.id,
  62. "X-OpenWebUI-User-Email": user.email,
  63. "X-OpenWebUI-User-Role": user.role,
  64. }
  65. if ENABLE_FORWARD_USER_INFO_HEADERS and user
  66. else {}
  67. ),
  68. },
  69. ssl=AIOHTTP_CLIENT_SESSION_SSL,
  70. ) as response:
  71. return await response.json()
  72. except Exception as e:
  73. # Handle connection error here
  74. log.error(f"Connection error: {e}")
  75. return None
  76. async def cleanup_response(
  77. response: Optional[aiohttp.ClientResponse],
  78. session: Optional[aiohttp.ClientSession],
  79. ):
  80. if response:
  81. response.close()
  82. if session:
  83. await session.close()
  84. def openai_reasoning_model_handler(payload):
  85. """
  86. Handle reasoning model specific parameters
  87. """
  88. if "max_tokens" in payload:
  89. # Convert "max_tokens" to "max_completion_tokens" for all reasoning models
  90. payload["max_completion_tokens"] = payload["max_tokens"]
  91. del payload["max_tokens"]
  92. # Handle system role conversion based on model type
  93. if payload["messages"][0]["role"] == "system":
  94. model_lower = payload["model"].lower()
  95. # Legacy models use "user" role instead of "system"
  96. if model_lower.startswith("o1-mini") or model_lower.startswith("o1-preview"):
  97. payload["messages"][0]["role"] = "user"
  98. else:
  99. payload["messages"][0]["role"] = "developer"
  100. return payload
  101. ##########################################
  102. #
  103. # API routes
  104. #
  105. ##########################################
  106. router = APIRouter()
  107. @router.get("/config")
  108. async def get_config(request: Request, user=Depends(get_admin_user)):
  109. return {
  110. "ENABLE_OPENAI_API": request.app.state.config.ENABLE_OPENAI_API,
  111. "OPENAI_API_BASE_URLS": request.app.state.config.OPENAI_API_BASE_URLS,
  112. "OPENAI_API_KEYS": request.app.state.config.OPENAI_API_KEYS,
  113. "OPENAI_API_CONFIGS": request.app.state.config.OPENAI_API_CONFIGS,
  114. }
  115. class OpenAIConfigForm(BaseModel):
  116. ENABLE_OPENAI_API: Optional[bool] = None
  117. OPENAI_API_BASE_URLS: list[str]
  118. OPENAI_API_KEYS: list[str]
  119. OPENAI_API_CONFIGS: dict
  120. @router.post("/config/update")
  121. async def update_config(
  122. request: Request, form_data: OpenAIConfigForm, user=Depends(get_admin_user)
  123. ):
  124. request.app.state.config.ENABLE_OPENAI_API = form_data.ENABLE_OPENAI_API
  125. request.app.state.config.OPENAI_API_BASE_URLS = form_data.OPENAI_API_BASE_URLS
  126. request.app.state.config.OPENAI_API_KEYS = form_data.OPENAI_API_KEYS
  127. # Check if API KEYS length is same than API URLS length
  128. if len(request.app.state.config.OPENAI_API_KEYS) != len(
  129. request.app.state.config.OPENAI_API_BASE_URLS
  130. ):
  131. if len(request.app.state.config.OPENAI_API_KEYS) > len(
  132. request.app.state.config.OPENAI_API_BASE_URLS
  133. ):
  134. request.app.state.config.OPENAI_API_KEYS = (
  135. request.app.state.config.OPENAI_API_KEYS[
  136. : len(request.app.state.config.OPENAI_API_BASE_URLS)
  137. ]
  138. )
  139. else:
  140. request.app.state.config.OPENAI_API_KEYS += [""] * (
  141. len(request.app.state.config.OPENAI_API_BASE_URLS)
  142. - len(request.app.state.config.OPENAI_API_KEYS)
  143. )
  144. request.app.state.config.OPENAI_API_CONFIGS = form_data.OPENAI_API_CONFIGS
  145. # Remove the API configs that are not in the API URLS
  146. keys = list(map(str, range(len(request.app.state.config.OPENAI_API_BASE_URLS))))
  147. request.app.state.config.OPENAI_API_CONFIGS = {
  148. key: value
  149. for key, value in request.app.state.config.OPENAI_API_CONFIGS.items()
  150. if key in keys
  151. }
  152. return {
  153. "ENABLE_OPENAI_API": request.app.state.config.ENABLE_OPENAI_API,
  154. "OPENAI_API_BASE_URLS": request.app.state.config.OPENAI_API_BASE_URLS,
  155. "OPENAI_API_KEYS": request.app.state.config.OPENAI_API_KEYS,
  156. "OPENAI_API_CONFIGS": request.app.state.config.OPENAI_API_CONFIGS,
  157. }
  158. @router.post("/audio/speech")
  159. async def speech(request: Request, user=Depends(get_verified_user)):
  160. idx = None
  161. try:
  162. idx = request.app.state.config.OPENAI_API_BASE_URLS.index(
  163. "https://api.openai.com/v1"
  164. )
  165. body = await request.body()
  166. name = hashlib.sha256(body).hexdigest()
  167. SPEECH_CACHE_DIR = CACHE_DIR / "audio" / "speech"
  168. SPEECH_CACHE_DIR.mkdir(parents=True, exist_ok=True)
  169. file_path = SPEECH_CACHE_DIR.joinpath(f"{name}.mp3")
  170. file_body_path = SPEECH_CACHE_DIR.joinpath(f"{name}.json")
  171. # Check if the file already exists in the cache
  172. if file_path.is_file():
  173. return FileResponse(file_path)
  174. url = request.app.state.config.OPENAI_API_BASE_URLS[idx]
  175. r = None
  176. try:
  177. r = requests.post(
  178. url=f"{url}/audio/speech",
  179. data=body,
  180. headers={
  181. "Content-Type": "application/json",
  182. "Authorization": f"Bearer {request.app.state.config.OPENAI_API_KEYS[idx]}",
  183. **(
  184. {
  185. "HTTP-Referer": "https://openwebui.com/",
  186. "X-Title": "Open WebUI",
  187. }
  188. if "openrouter.ai" in url
  189. else {}
  190. ),
  191. **(
  192. {
  193. "X-OpenWebUI-User-Name": quote(user.name, safe=" "),
  194. "X-OpenWebUI-User-Id": user.id,
  195. "X-OpenWebUI-User-Email": user.email,
  196. "X-OpenWebUI-User-Role": user.role,
  197. }
  198. if ENABLE_FORWARD_USER_INFO_HEADERS
  199. else {}
  200. ),
  201. },
  202. stream=True,
  203. )
  204. r.raise_for_status()
  205. # Save the streaming content to a file
  206. with open(file_path, "wb") as f:
  207. for chunk in r.iter_content(chunk_size=8192):
  208. f.write(chunk)
  209. with open(file_body_path, "w") as f:
  210. json.dump(json.loads(body.decode("utf-8")), f)
  211. # Return the saved file
  212. return FileResponse(file_path)
  213. except Exception as e:
  214. log.exception(e)
  215. detail = None
  216. if r is not None:
  217. try:
  218. res = r.json()
  219. if "error" in res:
  220. detail = f"External: {res['error']}"
  221. except Exception:
  222. detail = f"External: {e}"
  223. raise HTTPException(
  224. status_code=r.status_code if r else 500,
  225. detail=detail if detail else "Open WebUI: Server Connection Error",
  226. )
  227. except ValueError:
  228. raise HTTPException(status_code=401, detail=ERROR_MESSAGES.OPENAI_NOT_FOUND)
  229. async def get_all_models_responses(request: Request, user: UserModel) -> list:
  230. if not request.app.state.config.ENABLE_OPENAI_API:
  231. return []
  232. # Check if API KEYS length is same than API URLS length
  233. num_urls = len(request.app.state.config.OPENAI_API_BASE_URLS)
  234. num_keys = len(request.app.state.config.OPENAI_API_KEYS)
  235. if num_keys != num_urls:
  236. # if there are more keys than urls, remove the extra keys
  237. if num_keys > num_urls:
  238. new_keys = request.app.state.config.OPENAI_API_KEYS[:num_urls]
  239. request.app.state.config.OPENAI_API_KEYS = new_keys
  240. # if there are more urls than keys, add empty keys
  241. else:
  242. request.app.state.config.OPENAI_API_KEYS += [""] * (num_urls - num_keys)
  243. request_tasks = []
  244. for idx, url in enumerate(request.app.state.config.OPENAI_API_BASE_URLS):
  245. if (str(idx) not in request.app.state.config.OPENAI_API_CONFIGS) and (
  246. url not in request.app.state.config.OPENAI_API_CONFIGS # Legacy support
  247. ):
  248. request_tasks.append(
  249. send_get_request(
  250. f"{url}/models",
  251. request.app.state.config.OPENAI_API_KEYS[idx],
  252. user=user,
  253. )
  254. )
  255. else:
  256. api_config = request.app.state.config.OPENAI_API_CONFIGS.get(
  257. str(idx),
  258. request.app.state.config.OPENAI_API_CONFIGS.get(
  259. url, {}
  260. ), # Legacy support
  261. )
  262. enable = api_config.get("enable", True)
  263. model_ids = api_config.get("model_ids", [])
  264. if enable:
  265. if len(model_ids) == 0:
  266. request_tasks.append(
  267. send_get_request(
  268. f"{url}/models",
  269. request.app.state.config.OPENAI_API_KEYS[idx],
  270. user=user,
  271. )
  272. )
  273. else:
  274. model_list = {
  275. "object": "list",
  276. "data": [
  277. {
  278. "id": model_id,
  279. "name": model_id,
  280. "owned_by": "openai",
  281. "openai": {"id": model_id},
  282. "urlIdx": idx,
  283. }
  284. for model_id in model_ids
  285. ],
  286. }
  287. request_tasks.append(
  288. asyncio.ensure_future(asyncio.sleep(0, model_list))
  289. )
  290. else:
  291. request_tasks.append(asyncio.ensure_future(asyncio.sleep(0, None)))
  292. responses = await asyncio.gather(*request_tasks)
  293. for idx, response in enumerate(responses):
  294. if response:
  295. url = request.app.state.config.OPENAI_API_BASE_URLS[idx]
  296. api_config = request.app.state.config.OPENAI_API_CONFIGS.get(
  297. str(idx),
  298. request.app.state.config.OPENAI_API_CONFIGS.get(
  299. url, {}
  300. ), # Legacy support
  301. )
  302. connection_type = api_config.get("connection_type", "external")
  303. prefix_id = api_config.get("prefix_id", None)
  304. tags = api_config.get("tags", [])
  305. model_list = (
  306. response if isinstance(response, list) else response.get("data", [])
  307. )
  308. if not isinstance(model_list, list):
  309. # Catch non-list responses
  310. model_list = []
  311. for model in model_list:
  312. # Remove name key if its value is None #16689
  313. if "name" in model and model["name"] is None:
  314. del model["name"]
  315. if prefix_id:
  316. model["id"] = (
  317. f"{prefix_id}.{model.get('id', model.get('name', ''))}"
  318. )
  319. if tags:
  320. model["tags"] = tags
  321. if connection_type:
  322. model["connection_type"] = connection_type
  323. log.debug(f"get_all_models:responses() {responses}")
  324. return responses
  325. async def get_filtered_models(models, user):
  326. # Filter models based on user access control
  327. filtered_models = []
  328. for model in models.get("data", []):
  329. model_info = Models.get_model_by_id(model["id"])
  330. if model_info:
  331. if user.id == model_info.user_id or has_access(
  332. user.id, type="read", access_control=model_info.access_control
  333. ):
  334. filtered_models.append(model)
  335. return filtered_models
  336. @cached(ttl=MODELS_CACHE_TTL)
  337. async def get_all_models(request: Request, user: UserModel) -> dict[str, list]:
  338. log.info("get_all_models()")
  339. if not request.app.state.config.ENABLE_OPENAI_API:
  340. return {"data": []}
  341. responses = await get_all_models_responses(request, user=user)
  342. def extract_data(response):
  343. if response and "data" in response:
  344. return response["data"]
  345. if isinstance(response, list):
  346. return response
  347. return None
  348. def merge_models_lists(model_lists):
  349. log.debug(f"merge_models_lists {model_lists}")
  350. merged_list = []
  351. for idx, models in enumerate(model_lists):
  352. if models is not None and "error" not in models:
  353. merged_list.extend(
  354. [
  355. {
  356. **model,
  357. "name": model.get("name", model["id"]),
  358. "owned_by": "openai",
  359. "openai": model,
  360. "connection_type": model.get("connection_type", "external"),
  361. "urlIdx": idx,
  362. }
  363. for model in models
  364. if (model.get("id") or model.get("name"))
  365. and (
  366. "api.openai.com"
  367. not in request.app.state.config.OPENAI_API_BASE_URLS[idx]
  368. or not any(
  369. name in model["id"]
  370. for name in [
  371. "babbage",
  372. "dall-e",
  373. "davinci",
  374. "embedding",
  375. "tts",
  376. "whisper",
  377. ]
  378. )
  379. )
  380. ]
  381. )
  382. return merged_list
  383. models = {"data": merge_models_lists(map(extract_data, responses))}
  384. log.debug(f"models: {models}")
  385. request.app.state.OPENAI_MODELS = {model["id"]: model for model in models["data"]}
  386. return models
  387. @router.get("/models")
  388. @router.get("/models/{url_idx}")
  389. async def get_models(
  390. request: Request, url_idx: Optional[int] = None, user=Depends(get_verified_user)
  391. ):
  392. models = {
  393. "data": [],
  394. }
  395. if url_idx is None:
  396. models = await get_all_models(request, user=user)
  397. else:
  398. url = request.app.state.config.OPENAI_API_BASE_URLS[url_idx]
  399. key = request.app.state.config.OPENAI_API_KEYS[url_idx]
  400. api_config = request.app.state.config.OPENAI_API_CONFIGS.get(
  401. str(url_idx),
  402. request.app.state.config.OPENAI_API_CONFIGS.get(url, {}), # Legacy support
  403. )
  404. r = None
  405. async with aiohttp.ClientSession(
  406. trust_env=True,
  407. timeout=aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST),
  408. ) as session:
  409. try:
  410. headers = {
  411. "Content-Type": "application/json",
  412. **(
  413. {
  414. "X-OpenWebUI-User-Name": quote(user.name, safe=" "),
  415. "X-OpenWebUI-User-Id": user.id,
  416. "X-OpenWebUI-User-Email": user.email,
  417. "X-OpenWebUI-User-Role": user.role,
  418. }
  419. if ENABLE_FORWARD_USER_INFO_HEADERS
  420. else {}
  421. ),
  422. }
  423. if api_config.get("azure", False):
  424. models = {
  425. "data": api_config.get("model_ids", []) or [],
  426. "object": "list",
  427. }
  428. else:
  429. headers["Authorization"] = f"Bearer {key}"
  430. async with session.get(
  431. f"{url}/models",
  432. headers=headers,
  433. ssl=AIOHTTP_CLIENT_SESSION_SSL,
  434. ) as r:
  435. if r.status != 200:
  436. # Extract response error details if available
  437. error_detail = f"HTTP Error: {r.status}"
  438. res = await r.json()
  439. if "error" in res:
  440. error_detail = f"External Error: {res['error']}"
  441. raise Exception(error_detail)
  442. response_data = await r.json()
  443. # Check if we're calling OpenAI API based on the URL
  444. if "api.openai.com" in url:
  445. # Filter models according to the specified conditions
  446. response_data["data"] = [
  447. model
  448. for model in response_data.get("data", [])
  449. if not any(
  450. name in model["id"]
  451. for name in [
  452. "babbage",
  453. "dall-e",
  454. "davinci",
  455. "embedding",
  456. "tts",
  457. "whisper",
  458. ]
  459. )
  460. ]
  461. models = response_data
  462. except aiohttp.ClientError as e:
  463. # ClientError covers all aiohttp requests issues
  464. log.exception(f"Client error: {str(e)}")
  465. raise HTTPException(
  466. status_code=500, detail="Open WebUI: Server Connection Error"
  467. )
  468. except Exception as e:
  469. log.exception(f"Unexpected error: {e}")
  470. error_detail = f"Unexpected error: {str(e)}"
  471. raise HTTPException(status_code=500, detail=error_detail)
  472. if user.role == "user" and not BYPASS_MODEL_ACCESS_CONTROL:
  473. models["data"] = await get_filtered_models(models, user)
  474. return models
  475. class ConnectionVerificationForm(BaseModel):
  476. url: str
  477. key: str
  478. config: Optional[dict] = None
  479. @router.post("/verify")
  480. async def verify_connection(
  481. form_data: ConnectionVerificationForm, user=Depends(get_admin_user)
  482. ):
  483. url = form_data.url
  484. key = form_data.key
  485. api_config = form_data.config or {}
  486. async with aiohttp.ClientSession(
  487. trust_env=True,
  488. timeout=aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST),
  489. ) as session:
  490. try:
  491. headers = {
  492. "Content-Type": "application/json",
  493. **(
  494. {
  495. "X-OpenWebUI-User-Name": quote(user.name, safe=" "),
  496. "X-OpenWebUI-User-Id": user.id,
  497. "X-OpenWebUI-User-Email": user.email,
  498. "X-OpenWebUI-User-Role": user.role,
  499. }
  500. if ENABLE_FORWARD_USER_INFO_HEADERS
  501. else {}
  502. ),
  503. }
  504. if api_config.get("azure", False):
  505. headers["api-key"] = key
  506. api_version = api_config.get("api_version", "") or "2023-03-15-preview"
  507. async with session.get(
  508. url=f"{url}/openai/models?api-version={api_version}",
  509. headers=headers,
  510. ssl=AIOHTTP_CLIENT_SESSION_SSL,
  511. ) as r:
  512. try:
  513. response_data = await r.json()
  514. except Exception:
  515. response_data = await r.text()
  516. if r.status != 200:
  517. if isinstance(response_data, (dict, list)):
  518. return JSONResponse(
  519. status_code=r.status, content=response_data
  520. )
  521. else:
  522. return PlainTextResponse(
  523. status_code=r.status, content=response_data
  524. )
  525. return response_data
  526. else:
  527. headers["Authorization"] = f"Bearer {key}"
  528. async with session.get(
  529. f"{url}/models",
  530. headers=headers,
  531. ssl=AIOHTTP_CLIENT_SESSION_SSL,
  532. ) as r:
  533. try:
  534. response_data = await r.json()
  535. except Exception:
  536. response_data = await r.text()
  537. if r.status != 200:
  538. if isinstance(response_data, (dict, list)):
  539. return JSONResponse(
  540. status_code=r.status, content=response_data
  541. )
  542. else:
  543. return PlainTextResponse(
  544. status_code=r.status, content=response_data
  545. )
  546. return response_data
  547. except aiohttp.ClientError as e:
  548. # ClientError covers all aiohttp requests issues
  549. log.exception(f"Client error: {str(e)}")
  550. raise HTTPException(
  551. status_code=500, detail="Open WebUI: Server Connection Error"
  552. )
  553. except Exception as e:
  554. log.exception(f"Unexpected error: {e}")
  555. raise HTTPException(
  556. status_code=500, detail="Open WebUI: Server Connection Error"
  557. )
  558. def get_azure_allowed_params(api_version: str) -> set[str]:
  559. allowed_params = {
  560. "messages",
  561. "temperature",
  562. "role",
  563. "content",
  564. "contentPart",
  565. "contentPartImage",
  566. "enhancements",
  567. "dataSources",
  568. "n",
  569. "stream",
  570. "stop",
  571. "max_tokens",
  572. "presence_penalty",
  573. "frequency_penalty",
  574. "logit_bias",
  575. "user",
  576. "function_call",
  577. "functions",
  578. "tools",
  579. "tool_choice",
  580. "top_p",
  581. "log_probs",
  582. "top_logprobs",
  583. "response_format",
  584. "seed",
  585. "max_completion_tokens",
  586. }
  587. try:
  588. if api_version >= "2024-09-01-preview":
  589. allowed_params.add("stream_options")
  590. except ValueError:
  591. log.debug(
  592. f"Invalid API version {api_version} for Azure OpenAI. Defaulting to allowed parameters."
  593. )
  594. return allowed_params
  595. def is_openai_reasoning_model(model: str) -> bool:
  596. return model.lower().startswith(("o1", "o3", "o4", "gpt-5"))
  597. def convert_to_azure_payload(url, payload: dict, api_version: str):
  598. model = payload.get("model", "")
  599. # Filter allowed parameters based on Azure OpenAI API
  600. allowed_params = get_azure_allowed_params(api_version)
  601. # Special handling for o-series models
  602. if is_openai_reasoning_model(model):
  603. # Convert max_tokens to max_completion_tokens for o-series models
  604. if "max_tokens" in payload:
  605. payload["max_completion_tokens"] = payload["max_tokens"]
  606. del payload["max_tokens"]
  607. # Remove temperature if not 1 for o-series models
  608. if "temperature" in payload and payload["temperature"] != 1:
  609. log.debug(
  610. f"Removing temperature parameter for o-series model {model} as only default value (1) is supported"
  611. )
  612. del payload["temperature"]
  613. # Filter out unsupported parameters
  614. payload = {k: v for k, v in payload.items() if k in allowed_params}
  615. url = f"{url}/openai/deployments/{model}"
  616. return url, payload
  617. @router.post("/chat/completions")
  618. async def generate_chat_completion(
  619. request: Request,
  620. form_data: dict,
  621. user=Depends(get_verified_user),
  622. bypass_filter: Optional[bool] = False,
  623. ):
  624. if BYPASS_MODEL_ACCESS_CONTROL:
  625. bypass_filter = True
  626. idx = 0
  627. payload = {**form_data}
  628. metadata = payload.pop("metadata", None)
  629. model_id = form_data.get("model")
  630. model_info = Models.get_model_by_id(model_id)
  631. # Check model info and override the payload
  632. if model_info:
  633. if model_info.base_model_id:
  634. payload["model"] = model_info.base_model_id
  635. model_id = model_info.base_model_id
  636. params = model_info.params.model_dump()
  637. if params:
  638. system = params.pop("system", None)
  639. payload = apply_model_params_to_body_openai(params, payload)
  640. payload = apply_model_system_prompt_to_body(system, payload, metadata, user)
  641. # Check if user has access to the model
  642. if not bypass_filter and user.role == "user":
  643. if not (
  644. user.id == model_info.user_id
  645. or has_access(
  646. user.id, type="read", access_control=model_info.access_control
  647. )
  648. ):
  649. raise HTTPException(
  650. status_code=403,
  651. detail="Model not found",
  652. )
  653. elif not bypass_filter:
  654. if user.role != "admin":
  655. raise HTTPException(
  656. status_code=403,
  657. detail="Model not found",
  658. )
  659. await get_all_models(request, user=user)
  660. model = request.app.state.OPENAI_MODELS.get(model_id)
  661. if model:
  662. idx = model["urlIdx"]
  663. else:
  664. raise HTTPException(
  665. status_code=404,
  666. detail="Model not found",
  667. )
  668. # Get the API config for the model
  669. api_config = request.app.state.config.OPENAI_API_CONFIGS.get(
  670. str(idx),
  671. request.app.state.config.OPENAI_API_CONFIGS.get(
  672. request.app.state.config.OPENAI_API_BASE_URLS[idx], {}
  673. ), # Legacy support
  674. )
  675. prefix_id = api_config.get("prefix_id", None)
  676. if prefix_id:
  677. payload["model"] = payload["model"].replace(f"{prefix_id}.", "")
  678. # Add user info to the payload if the model is a pipeline
  679. if "pipeline" in model and model.get("pipeline"):
  680. payload["user"] = {
  681. "name": user.name,
  682. "id": user.id,
  683. "email": user.email,
  684. "role": user.role,
  685. }
  686. url = request.app.state.config.OPENAI_API_BASE_URLS[idx]
  687. key = request.app.state.config.OPENAI_API_KEYS[idx]
  688. # Check if model is a reasoning model that needs special handling
  689. if is_openai_reasoning_model(payload["model"]):
  690. payload = openai_reasoning_model_handler(payload)
  691. elif "api.openai.com" not in url:
  692. # Remove "max_completion_tokens" from the payload for backward compatibility
  693. if "max_completion_tokens" in payload:
  694. payload["max_tokens"] = payload["max_completion_tokens"]
  695. del payload["max_completion_tokens"]
  696. if "max_tokens" in payload and "max_completion_tokens" in payload:
  697. del payload["max_tokens"]
  698. # Convert the modified body back to JSON
  699. if "logit_bias" in payload:
  700. payload["logit_bias"] = json.loads(
  701. convert_logit_bias_input_to_json(payload["logit_bias"])
  702. )
  703. headers = {
  704. "Content-Type": "application/json",
  705. **(
  706. {
  707. "HTTP-Referer": "https://openwebui.com/",
  708. "X-Title": "Open WebUI",
  709. }
  710. if "openrouter.ai" in url
  711. else {}
  712. ),
  713. **(
  714. {
  715. "X-OpenWebUI-User-Name": quote(user.name, safe=" "),
  716. "X-OpenWebUI-User-Id": user.id,
  717. "X-OpenWebUI-User-Email": user.email,
  718. "X-OpenWebUI-User-Role": user.role,
  719. **(
  720. {"X-OpenWebUI-Chat-Id": metadata.get("chat_id")}
  721. if metadata and metadata.get("chat_id")
  722. else {}
  723. ),
  724. }
  725. if ENABLE_FORWARD_USER_INFO_HEADERS
  726. else {}
  727. ),
  728. }
  729. if api_config.get("azure", False):
  730. api_version = api_config.get("api_version", "2023-03-15-preview")
  731. request_url, payload = convert_to_azure_payload(url, payload, api_version)
  732. headers["api-key"] = key
  733. headers["api-version"] = api_version
  734. request_url = f"{request_url}/chat/completions?api-version={api_version}"
  735. else:
  736. request_url = f"{url}/chat/completions"
  737. headers["Authorization"] = f"Bearer {key}"
  738. payload = json.dumps(payload)
  739. r = None
  740. session = None
  741. streaming = False
  742. response = None
  743. try:
  744. session = aiohttp.ClientSession(
  745. trust_env=True, timeout=aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT)
  746. )
  747. r = await session.request(
  748. method="POST",
  749. url=request_url,
  750. data=payload,
  751. headers=headers,
  752. ssl=AIOHTTP_CLIENT_SESSION_SSL,
  753. )
  754. # Check if response is SSE
  755. if "text/event-stream" in r.headers.get("Content-Type", ""):
  756. streaming = True
  757. return StreamingResponse(
  758. r.content,
  759. status_code=r.status,
  760. headers=dict(r.headers),
  761. background=BackgroundTask(
  762. cleanup_response, response=r, session=session
  763. ),
  764. )
  765. else:
  766. try:
  767. response = await r.json()
  768. except Exception as e:
  769. log.error(e)
  770. response = await r.text()
  771. if r.status >= 400:
  772. if isinstance(response, (dict, list)):
  773. return JSONResponse(status_code=r.status, content=response)
  774. else:
  775. return PlainTextResponse(status_code=r.status, content=response)
  776. return response
  777. except Exception as e:
  778. log.exception(e)
  779. raise HTTPException(
  780. status_code=r.status if r else 500,
  781. detail="Open WebUI: Server Connection Error",
  782. )
  783. finally:
  784. if not streaming:
  785. await cleanup_response(r, session)
  786. async def embeddings(request: Request, form_data: dict, user):
  787. """
  788. Calls the embeddings endpoint for OpenAI-compatible providers.
  789. Args:
  790. request (Request): The FastAPI request context.
  791. form_data (dict): OpenAI-compatible embeddings payload.
  792. user (UserModel): The authenticated user.
  793. Returns:
  794. dict: OpenAI-compatible embeddings response.
  795. """
  796. idx = 0
  797. # Prepare payload/body
  798. body = json.dumps(form_data)
  799. # Find correct backend url/key based on model
  800. await get_all_models(request, user=user)
  801. model_id = form_data.get("model")
  802. models = request.app.state.OPENAI_MODELS
  803. if model_id in models:
  804. idx = models[model_id]["urlIdx"]
  805. url = request.app.state.config.OPENAI_API_BASE_URLS[idx]
  806. key = request.app.state.config.OPENAI_API_KEYS[idx]
  807. r = None
  808. session = None
  809. streaming = False
  810. try:
  811. session = aiohttp.ClientSession(trust_env=True)
  812. r = await session.request(
  813. method="POST",
  814. url=f"{url}/embeddings",
  815. data=body,
  816. headers={
  817. "Authorization": f"Bearer {key}",
  818. "Content-Type": "application/json",
  819. **(
  820. {
  821. "X-OpenWebUI-User-Name": quote(user.name, safe=" "),
  822. "X-OpenWebUI-User-Id": user.id,
  823. "X-OpenWebUI-User-Email": user.email,
  824. "X-OpenWebUI-User-Role": user.role,
  825. }
  826. if ENABLE_FORWARD_USER_INFO_HEADERS and user
  827. else {}
  828. ),
  829. },
  830. )
  831. if "text/event-stream" in r.headers.get("Content-Type", ""):
  832. streaming = True
  833. return StreamingResponse(
  834. r.content,
  835. status_code=r.status,
  836. headers=dict(r.headers),
  837. background=BackgroundTask(
  838. cleanup_response, response=r, session=session
  839. ),
  840. )
  841. else:
  842. try:
  843. response_data = await r.json()
  844. except Exception:
  845. response_data = await r.text()
  846. if r.status >= 400:
  847. if isinstance(response_data, (dict, list)):
  848. return JSONResponse(status_code=r.status, content=response_data)
  849. else:
  850. return PlainTextResponse(
  851. status_code=r.status, content=response_data
  852. )
  853. return response_data
  854. except Exception as e:
  855. log.exception(e)
  856. raise HTTPException(
  857. status_code=r.status if r else 500,
  858. detail="Open WebUI: Server Connection Error",
  859. )
  860. finally:
  861. if not streaming:
  862. await cleanup_response(r, session)
  863. @router.api_route("/{path:path}", methods=["GET", "POST", "PUT", "DELETE"])
  864. async def proxy(path: str, request: Request, user=Depends(get_verified_user)):
  865. """
  866. Deprecated: proxy all requests to OpenAI API
  867. """
  868. body = await request.body()
  869. idx = 0
  870. url = request.app.state.config.OPENAI_API_BASE_URLS[idx]
  871. key = request.app.state.config.OPENAI_API_KEYS[idx]
  872. api_config = request.app.state.config.OPENAI_API_CONFIGS.get(
  873. str(idx),
  874. request.app.state.config.OPENAI_API_CONFIGS.get(
  875. request.app.state.config.OPENAI_API_BASE_URLS[idx], {}
  876. ), # Legacy support
  877. )
  878. r = None
  879. session = None
  880. streaming = False
  881. try:
  882. headers = {
  883. "Content-Type": "application/json",
  884. **(
  885. {
  886. "X-OpenWebUI-User-Name": quote(user.name, safe=" "),
  887. "X-OpenWebUI-User-Id": user.id,
  888. "X-OpenWebUI-User-Email": user.email,
  889. "X-OpenWebUI-User-Role": user.role,
  890. }
  891. if ENABLE_FORWARD_USER_INFO_HEADERS
  892. else {}
  893. ),
  894. }
  895. if api_config.get("azure", False):
  896. api_version = api_config.get("api_version", "2023-03-15-preview")
  897. headers["api-key"] = key
  898. headers["api-version"] = api_version
  899. payload = json.loads(body)
  900. url, payload = convert_to_azure_payload(url, payload, api_version)
  901. body = json.dumps(payload).encode()
  902. request_url = f"{url}/{path}?api-version={api_version}"
  903. else:
  904. headers["Authorization"] = f"Bearer {key}"
  905. request_url = f"{url}/{path}"
  906. session = aiohttp.ClientSession(trust_env=True)
  907. r = await session.request(
  908. method=request.method,
  909. url=request_url,
  910. data=body,
  911. headers=headers,
  912. ssl=AIOHTTP_CLIENT_SESSION_SSL,
  913. )
  914. # Check if response is SSE
  915. if "text/event-stream" in r.headers.get("Content-Type", ""):
  916. streaming = True
  917. return StreamingResponse(
  918. r.content,
  919. status_code=r.status,
  920. headers=dict(r.headers),
  921. background=BackgroundTask(
  922. cleanup_response, response=r, session=session
  923. ),
  924. )
  925. else:
  926. try:
  927. response_data = await r.json()
  928. except Exception:
  929. response_data = await r.text()
  930. if r.status >= 400:
  931. if isinstance(response_data, (dict, list)):
  932. return JSONResponse(status_code=r.status, content=response_data)
  933. else:
  934. return PlainTextResponse(
  935. status_code=r.status, content=response_data
  936. )
  937. return response_data
  938. except Exception as e:
  939. log.exception(e)
  940. raise HTTPException(
  941. status_code=r.status if r else 500,
  942. detail="Open WebUI: Server Connection Error",
  943. )
  944. finally:
  945. if not streaming:
  946. await cleanup_response(r, session)