BYOK & LLM-провайдерцәа

AIHUMMER_LLM_PROVIDER=openai
AIHUMMER_LLM_MODEL=gpt-4o-mini
AIHUMMER_LLM_GATEWAY_URL=https://api.openai.com/v1
AIHUMMER_OPENAI_API_KEY=sk-...

AIHUMMER_LLM_PROVIDER=openai
AIHUMMER_LLM_MODEL=qwen2.5-instruct
AIHUMMER_LLM_GATEWAY_URL=http://127.0.0.1:8080/v1

GET  /v1/admin/byok
POST /v1/admin/byok

AiHummer мацара *аҭахым* ахԥса змоу амодель. Аҿыхра ашьҭахь иара аус ауеит ихашәоу насгьы ауада-иҟоу амоделцәа рыла насгьы Codex/ChatGPT-абонемент атранспорт ала, насгьы амодель зегь ахьамкоу аҿы арантайм деаҵакны имитациа дшацлоит, убри аҟнытә аплатформа уаҳагьы иалагоит насгьы итестртәуп. Уи ахьыҷкны ишәҭахызар амодель аартәоу, ишәҩꙑзеит ишәара — ма апроцесс зегьаҿы ахархәара ала ма, тенант-ала, **BYOK** ала ("шәара иужь-иужьтәи акалит ишәырга"). ## Иадгылоу LLM-провайдерцәа AiHummer диааира аус амоуеит зегьы провайдер OpenAI-стиль ала ачат API зкоу, насгьы Anthropic насгьы ChatGPT-абонемент атранспорт. Ишыҟоу ала уи иаԥшьаргоит: | Провайдер | Ишԥаизаацало | Азгәаҭақәа | |---|---|---| | **Anthropic** | Иҷыдоу Anthropic API | Claude амоделцәа | | **OpenAI** | OpenAI ачат API | | | **Зегьы OpenAI-API-стандарт ахьыргоу** | OpenAI-иадҳәалоу шлюз URL | Ауада-иҟоу амоделцәа, OpenRouter, Gemini-и OpenAI-иадҳәалоу API, насгьы аиҷ. | | **Codex / ChatGPT-абонемент атранспорт** | Абонемент-ала иҟоу атранспорт | Ихархәоит ChatGPT-абонемент, иаалырҟьаны иарбоу API-калит акыр | > [!WARNING] > Ахԥса змоу амодель API зегь иуадаҩымкуа иаҭахым. AiHummer аус ауеит ихашәоу/ауада-иҟоу амоделцәа рыла насгьы > Codex/ChatGPT-абонемент атранспорт ала, насгьы **амодель ахьамшьшьоу аранҭайм > деаҵакны имитациа ихаирхәоит** — ашлюз уаҳагьы иалагоит насгьы дзыцклаԥшуеит. > BYOK насгьы ахԥса змоу акалитқәа зегьы иабжьам. ## Амодель аарԥшра аамҭарбагатә переменныкуа рыла Амодель алырхуеит ԥшьба аамҭарбагатә переменныкуа рыла. Иргылар провайдери амодели, ишьҭаргалатәуп ашлюз URL OpenAI-иадҳәалоу хьырргоу разы, насгьы иргалатәуп акалит ахьыргоу ахьаҭахызар: ```ini AIHUMMER_LLM_PROVIDER=openai AIHUMMER_LLM_MODEL=gpt-4o-mini AIHUMMER_LLM_GATEWAY_URL=https://api.openai.com/v1 AIHUMMER_OPENAI_API_KEY=sk-... ``` Ауада-иҟоу OpenAI-иадҳәалоу сервер разы, ашлюз URL уи ишьҭаргалатәуп насгьы акалит маҷкы иаҭахым: ```ini AIHUMMER_LLM_PROVIDER=openai AIHUMMER_LLM_MODEL=qwen2.5-instruct AIHUMMER_LLM_GATEWAY_URL=http://127.0.0.1:8080/v1 ``` `AIHUMMER_LLM_PROVIDER` / `AIHUMMER_LLM_MODEL` ахьыҟам аҿы, деаҵакны имитациа ихархәоуп. ## BYOK: тенант-ала акалитқәа Аамҭарбагатә переменныкуа апроцесс зегьаҿы амодель аарԥшуазар, **BYOK** зегьы тенант ииужь-иужьтәи LLM-каритализ аргарц иадгылоит. BYOK акалитқәа изхылаԥшуеит аадмин API ала: ```http GET /v1/admin/byok POST /v1/admin/byok ``` BYOK акалитқәа иҵәахоуп ишифрованоу хранилище аҿы, егьырҭ зегьы каритализ реиԥшҵас — урҭ заҩымак иҩымхо логқәа рҿы насгьы амодель аконтекст рҿы иаамхәуам. Уи ауп аплатформа мультитенант-ала аиҿартәра аҿы зегьы клиент имодель ахԥса насгьы акалит аматериал хазы иааныжьырц зылшо. ## Env насгьы BYOK рыбжьара алхра - Иршәырха **`AIHUMMER_LLM_*` аамҭарбагатә переменныкуа** еицырҟоу тенант ма адефолт амодель разы зегьы ашлюз ахархәалатәу. - Иршәырха **BYOK** еиԥшым тенантцәа еиԥшым акалитқәа, еиԥшым провайдерцәа рхархәара ма хазы ахԥса рыргарц иаҭахызар — тенант-ала акалит адефолт иавлеит убри тенант разы. > [!TIP] > Зегьы OpenAI-API-стандарт ахьырргоу иадоуп ауп, шәара иршәырга ауада-иҟоу амодель > сервер, OpenRouter ма Gemini OpenAI-иадҳәалоу хьырргоу > `AIHUMMER_LLM_GATEWAY_URL` ашьҭахь, AiHummer аҿы егьырҭ зегьы ахьымдыруа. ## Уи аиааира аус амоуеит аидоступ амодель егьырҭ ацрахьҵаны BYOK акалитқәа амодель каритализуп насгьы инхоит убри ишифрованоу хранилище аҿы [Иадҳәалареи](/en/v1.0/access/connections-oauth2) шәоу/иужь-иужьтәи секретқәа реиԥшҵас. Аиԥшымра аус аусура: BYOK иаҭакуеит *иарбану амодельи акалити уи тенант ихархәо*, *иужь-иужьтәи насгьы ишәоу* [иужь-иужьтәии шәоуи](/en/v1.0/access/personal-vs-shared) аус аусура иаҭакуеит *иарбану калитализ ала иарбоу абжьабыргра аус ауа*. ## Уаха ахь - [Иужь-иужьтәии шәоуи каритализ](/en/v1.0/access/personal-vs-shared) - [Иадҳәалареи (тенант-ала OAuth2)](/en/v1.0/access/connections-oauth2) - [Аалагаратә](/en/v1.0/getting-started/introduction) — ахԥса змам амоделцәа апринцип аконтекст аҿы.