Microsoft.Extensions.AI API: адаптер и проверка
В .NET адрес задаётся в OpenAIClientOptions.Endpoint, затем клиент оборачивается в IChatClient. Эту часть мы не читали в документации до конца, страница помечена «частично».
- Тип: Фреймворк и SDK
- Протокол: OpenAI Chat Completions
- Статус: Частично
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Потоковый ответ | Да |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/ (bash: ~/, bash на macOS: ~/), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.
Ключ в переменной окружения
macOS и Linux
read -rs RELAY_API_KEY && export RELAY_API_KEYWindows PowerShell
$env:RELAY_API_KEY = "YOUR_API_KEY"Windows cmd
set "RELAY_API_KEY=YOUR_API_KEY"- Установите пакеты
OpenAIиMicrosoft.Extensions.AI.OpenAI, задайте ключ в переменнойRELAY_API_KEY. - Создайте
OpenAIClientсEndpointhttps://, получите чат-клиент для модели из каталога (в примереrelay-llm.ru/ v1 gpt-5.6-luna) и оберните его вIChatClient.
Пример на C#
using System.ClientModel;
using Microsoft.Extensions.AI;
using OpenAI;
var options = new OpenAIClientOptions { Endpoint = new Uri("https://relay-llm.ru/v1") };
var key = new ApiKeyCredential(Environment.GetEnvironmentVariable("RELAY_API_KEY")!);
IChatClient chat = new OpenAIClient(key, options).GetChatClient("gpt-5.6-luna").AsIChatClient();
var reply = await chat.GetResponseAsync("ping");
Console.WriteLine(reply.Text);Проверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Запустите пример: он напечатает ответ модели. Запись видна в журнале запросов кабинета.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Ловушки
- Умолчание адреса в исходниках
openai-dotnetмы не проверяли. По аналогии с остальными SDK OpenAI ожидается/.v1 - Название метода-адаптера зависит от версии пакета: в одних он
AsIChatClient, в другихAsChatClient. Сверьтесь с установленной версией. - Для моделей Claude официальный пакет Anthropic для .NET версии 10 и новее принимает
BaseUrlбез/. Старые версии с тем же именем принадлежат стороннему SDK: можно взять не тот пакет.v1
Ссылки
Официальная документация: Microsoft.Extensions.AI API: адаптер и проверка
Подключение клиентов: общие сведения и все клиенты