Разработчикам

Документация публичного API Trialix

Базовый адрес https://api.trialix.ru/v1 для OpenAI-совместимых клиентов и https://api.trialix.ru для Anthropic SDK и Claude Code. Ключ - персональный «Мой ключ» сотрудника или ключ компании из ЛК. Все запросы проходят политики доступа, лимиты, биллинг и обезличивание компании.

OpenAPI: openapi.json Примеры и интеграции в портале Об API коротко Сервер MCP

Быстрый старт

Три запроса, чтобы проверить ключ

Ключ выпускается в портале («Мой ключ») или в ЛК компании («Разработчикам»). Заголовок Authorization: Bearer или x-api-key. В каждом ответе - x-request-id и x-trialix-anonymized (сколько сущностей замаскировано перед отправкой модели), в usage.trialix - цена запроса в рублях.

1. Chat Completions (OpenAI-совместимо), модель Claude Sonnet 5.5

curl https://api.trialix.ru/v1/chat/completions \
  -H "Authorization: Bearer $TRIALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "Кратко: что такое оферта?"}]
  }'

2. Агент компании как модель: agent:<slug>

from openai import OpenAI

client = OpenAI(base_url="https://api.trialix.ru/v1", api_key="trx_ВАШ_КЛЮЧ")
resp = client.chat.completions.create(
    model="agent:sverka-kp",   # агент компании как модель (slug из GET /v1/models)
    messages=[{"role": "user", "content": "Сравни два КП по срокам и штрафам"}],
)
print(resp.choices[0].message.content)
print(resp.usage.model_extra["trialix"]["price_rub"], "₽")

3. Anthropic Messages: так подключается Claude Code

curl https://api.trialix.ru/v1/messages \
  -H "x-api-key: $TRIALIX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 512, "messages": [{"role": "user", "content": "Привет"}]}'

Claude Code: переменные окружения

export ANTHROPIC_BASE_URL=https://api.trialix.ru
export ANTHROPIC_API_KEY=trx_ВАШ_КЛЮЧ
export ANTHROPIC_MODEL=claude-sonnet-5-5
claude

В поле model - любая модель из прайса (claude-sonnet-5-5, yandexgpt-5.1-pro) или агент компании agent:<slug>: slug виден в GET /v1/models. У агента применяются его инструкция, базы знаний и веб-поиск. Расход списывается с баланса компании и виден в /v1/usage.

Российские модели

Данные не покидают Россию через тот же API

Модели Яндекса (YandexGPT 5.1 Pro, YandexGPT 5 Lite, Alice AI LLM, Alice AI LLM Flash, DeepSeek V4.1 Flash (Яндекс)) вызываются теми же эндпоинтами: меняется только имя модели. В GET /v1/models у каждой модели указана страна обработки данных, а политика компании может разрешить сотруднику только российские модели.

Python: YandexGPT 5.1 Pro (1 760 / 1 760 TRX за 1M токенов)

from openai import OpenAI

client = OpenAI(base_url="https://api.trialix.ru/v1", api_key="trx_ВАШ_КЛЮЧ")
r = client.chat.completions.create(
    model="yandexgpt-5.1-pro",   # данные не покидают Россию: серверы Яндекса
    messages=[{"role": "user", "content": "Составь план встречи с поставщиком"}],
    max_tokens=800,
)
print(r.choices[0].message.content)

# список моделей ключа со страной обработки данных
for m in client.models.list():
    print(m.id, m.model_extra.get("trialix", {}).get("data_country"))

curl со стримом: YandexGPT 5.1 Pro

curl -N https://api.trialix.ru/v1/chat/completions \
  -H "Authorization: Bearer $TRIALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "yandexgpt-5.1-pro", "stream": true, "stream_options": {"include_usage": true},
       "messages": [{"role": "user", "content": "Три риска договора поставки с постоплатой"}]}'

Эндпоинты

Одна точка входа, знакомые форматы

Ошибки приходят в едином формате {error: {message, type, param, code}} (для /v1/messages - в формате Anthropic) с понятными кодами: model_not_allowed_for_policy, quota_exceeded, cost_confirmation_required, anonymization_unavailable. Полный список кодов, параметров и примеры на Python и JavaScript - в портале.

POST /v1/chat/completions

чат в формате OpenAI: стрим, инструменты, JSON-режим, картинки на вход

POST /v1/messages

Anthropic Messages с кэшем промпта - так подключается Claude Code

POST /v1/responses

Responses API для Codex CLI: previous_response_id, состояние 24 часа

POST /v1/embeddings

эмбеддинги для поиска и RAG (text-embedding-3-small, Yandex Text Embeddings v2)

GET /v1/models

доступные ключу модели и агенты компании (agent:<slug>), страна обработки данных

GET /v1/usage

расход компании в рублях по дням, ключам, сотрудникам и моделям

POST /v1/images/generations и /edits

картинки: генерация и правка, OpenAI-совместимо, цена за штуку

POST /v1/media/videos, /music, /speech, /transcriptions

видео, музыка, озвучка и расшифровка - фоновые задания, GET /v1/media/{id}

Модели

Идентификаторы моделей для поля model

Список из каталога Trialix: те же имена принимает API. Снятые с продаж модели принимаются по прежнему идентификатору до отключения у провайдера и уходят преемнику. Цены - на странице тарифов.

claude-fable-5
Claude Fable 5.1 · Anthropic · контекст 1 млн токенов
за рубежом, с обезличиванием
claude-opus-5-5
Claude Opus 5.5 · Anthropic · контекст 1 млн токенов
за рубежом, с обезличиванием
gpt-6-astra
GPT-6 Astra · OpenAI · контекст 1 млн токенов
за рубежом, с обезличиванием
gemini-3.1-pro
Gemini 3.1 Pro · Google · контекст 200 тыс. токенов
за рубежом, с обезличиванием
gemini-4-argon
Gemini 4 Argon · Google · контекст 1 млн токенов
за рубежом, с обезличиванием
claude-sonnet-5-5
Claude Sonnet 5.5 · Anthropic · контекст 1 млн токенов
за рубежом, с обезличиванием
gpt-6.1-sol
GPT-6.1 Sol · OpenAI · контекст 1 млн токенов
за рубежом, с обезличиванием
grok-4.7
Grok 4.7 · xAI · контекст 500 тыс. токенов
за рубежом, с обезличиванием
deepseek-v4-pro
DeepSeek V4 Pro · DeepSeek · контекст 1 млн токенов
за рубежом, с обезличиванием
claude-haiku-5-5
Claude Haiku 5.5 · Anthropic · контекст 1 млн токенов
за рубежом, с обезличиванием
gemini-3.8-flash
Gemini 3.8 Flash · Google · контекст 1 млн токенов
за рубежом, с обезличиванием
gemini-3.1-flash-lite
Gemini 3.1 Flash-Lite · Google · контекст 1 млн токенов
за рубежом, с обезличиванием
gemini-3.5-flash-lite
Gemini 3.5 Flash-Lite · Google · контекст 1 млн токенов
за рубежом, с обезличиванием
gpt-6-luna
GPT-6 Luna · OpenAI · контекст 1 млн токенов
за рубежом, с обезличиванием
grok-4.3
Grok 4.3 · xAI · контекст 1 млн токенов
за рубежом, с обезличиванием
deepseek-flash
DeepSeek V4.1 Flash · DeepSeek · контекст 1 млн токенов
за рубежом, с обезличиванием
yandexgpt-5.1-pro
YandexGPT 5.1 Pro · Яндекс · контекст 32 тыс. токенов
в России
yandexgpt-5-lite
YandexGPT 5 Lite · Яндекс · контекст 32 тыс. токенов
в России
aliceai-llm
Alice AI LLM · Яндекс · контекст 128 тыс. токенов
в России
aliceai-llm-flash
Alice AI LLM Flash · Яндекс · контекст 64 тыс. токенов
в России
deepseek-v4.1-flash-ru
DeepSeek V4.1 Flash (Яндекс) · Яндекс · контекст 1 млн токенов
в России
trx-lite-cloud
TRX-Lite Cloud · MWS · контекст 256 тыс. токенов
в России
trx-max-cloud
TRX-Max Cloud · MWS · контекст 128 тыс. токенов
в России
trx-coder-cloud
TRX-Coder Cloud · MWS · контекст 256 тыс. токенов
в России

model	Название	Провайдер	Контекст, токенов	Данные
`claude-fable-5`	Claude Fable 5.1	Anthropic	1 млн	за рубежом, с обезличиванием
`claude-opus-5-5`	Claude Opus 5.5	Anthropic	1 млн	за рубежом, с обезличиванием
`gpt-6-astra`	GPT-6 Astra	OpenAI	1 млн	за рубежом, с обезличиванием
`gemini-3.1-pro`	Gemini 3.1 Pro	Google	200 тыс.	за рубежом, с обезличиванием
`gemini-4-argon`	Gemini 4 Argon	Google	1 млн	за рубежом, с обезличиванием
`claude-sonnet-5-5`	Claude Sonnet 5.5	Anthropic	1 млн	за рубежом, с обезличиванием
`gpt-6.1-sol`	GPT-6.1 Sol	OpenAI	1 млн	за рубежом, с обезличиванием
`grok-4.7`	Grok 4.7	xAI	500 тыс.	за рубежом, с обезличиванием
`deepseek-v4-pro`	DeepSeek V4 Pro	DeepSeek	1 млн	за рубежом, с обезличиванием
`claude-haiku-5-5`	Claude Haiku 5.5	Anthropic	1 млн	за рубежом, с обезличиванием
`gemini-3.8-flash`	Gemini 3.8 Flash	Google	1 млн	за рубежом, с обезличиванием
`gemini-3.1-flash-lite`	Gemini 3.1 Flash-Lite	Google	1 млн	за рубежом, с обезличиванием
`gemini-3.5-flash-lite`	Gemini 3.5 Flash-Lite	Google	1 млн	за рубежом, с обезличиванием
`gpt-6-luna`	GPT-6 Luna	OpenAI	1 млн	за рубежом, с обезличиванием
`grok-4.3`	Grok 4.3	xAI	1 млн	за рубежом, с обезличиванием
`deepseek-flash`	DeepSeek V4.1 Flash	DeepSeek	1 млн	за рубежом, с обезличиванием
`yandexgpt-5.1-pro`	YandexGPT 5.1 Pro	Яндекс	32 тыс.	в России
`yandexgpt-5-lite`	YandexGPT 5 Lite	Яндекс	32 тыс.	в России
`aliceai-llm`	Alice AI LLM	Яндекс	128 тыс.	в России
`aliceai-llm-flash`	Alice AI LLM Flash	Яндекс	64 тыс.	в России
`deepseek-v4.1-flash-ru`	DeepSeek V4.1 Flash (Яндекс)	Яндекс	1 млн	в России
`trx-lite-cloud`	TRX-Lite Cloud	MWS	256 тыс.	в России
`trx-max-cloud`	TRX-Max Cloud	MWS	128 тыс.	в России
`trx-coder-cloud`	TRX-Coder Cloud	MWS	256 тыс.	в России

Эмбеддинги: text-embedding-3-small (1536 измерений) и yandex-embeddings-v2 (серверы в России). Медиа-модели и их параметры - в описании /v1/images/* и /v1/media/* в портале.

MCP

Подключение из Cursor, Claude Code и других клиентов

Trialix работает как сервер MCP: редактор кода, чат-клиент или своя программа получает инструменты подключённых систем компании, поиск по базе знаний и агентов компании. Вход - по личному ключу сотрудника («Мой ключ») или ключу компании. Вызовы проходят те же политики доступа, лимиты, обезличивание и журнал, что в чате Trialix.

Адрес: https://api.trialix.ru/mcp
Вход по ключу API: Authorization: Bearer <ключ>
Протокол: Streamable HTTP, 2025-06-18 и 2025-03-26, ответ JSON или SSE

Cursor

Файл ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json в папке проекта. После сохранения сервер trialix появится в настройках MCP в Cursor.

{
  "mcpServers": {
    "trialix": {
      "url": "https://api.trialix.ru/mcp",
      "headers": { "Authorization": "Bearer <TRIALIX_API_KEY>" }
    }
  }
}

Claude Code

Команда в терминале. С флагом --scope user сервер доступен во всех проектах; список серверов и их состояние - команда /mcp в Claude Code.

claude mcp add --transport http trialix https://api.trialix.ru/mcp \
  --header "Authorization: Bearer <TRIALIX_API_KEY>"

Claude Desktop

Файл claude_desktop_config.json (Settings › Developer › Edit Config), затем перезапуск приложения. Ключ передаётся через мост mcp-remote, нужен Node.js 18 или новее.

{
  "mcpServers": {
    "trialix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.trialix.ru/mcp", "--header", "Authorization:${TRIALIX_AUTH}"],
      "env": { "TRIALIX_AUTH": "Bearer <TRIALIX_API_KEY>" }
    }
  }
}

SDK TypeScript

Пакет @modelcontextprotocol/sdk, транспорт Streamable HTTP. Ключ - из переменной окружения TRIALIX_API_KEY.

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(new URL('https://api.trialix.ru/mcp'), {
  requestInit: { headers: { Authorization: `Bearer ${process.env.TRIALIX_API_KEY}` } },
});
const client = new Client({ name: 'my-app', version: '1.0.0' });
await client.connect(transport);

const { tools } = await client.listTools();
const found = await client.callTool({ name: 'search_tools', arguments: { query: 'сделки в Битрикс24' } });
console.log(found.content);

SDK Python

Пакет mcp, транспорт Streamable HTTP. Ключ - из переменной окружения TRIALIX_API_KEY.

import asyncio, os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    headers = {"Authorization": f"Bearer {os.environ['TRIALIX_API_KEY']}"}
    async with streamablehttp_client("https://api.trialix.ru/mcp", headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])
            found = await session.call_tool("search_tools", {"query": "сделки в Битрикс24"})
            print(found.content[0].text)

asyncio.run(main())

Вместо <TRIALIX_API_KEY> - значение ключа. Другие клиенты с транспортом Streamable HTTP подключаются так же: адрес сервера и заголовок Authorization.

Инструменты

search_tools

находит инструменты подключённых систем по задаче своими словами: до 10 коротких сигнатур вместо сотен полных схем

В списке: всегда

<система>__<инструмент>

инструмент системы, например bitrix24__deals_list: чтение выполняется сразу, запись ждёт подтверждения

В списке: пока инструментов подключений не больше 30

call_tool

вызывает найденный поиском инструмент: name и arguments по его сигнатуре

В списке: когда инструментов подключений больше 30

kb_search

фрагменты документов баз знаний компании с названием документа

В списке: личный ключ или ключ компании с «Поиск по базам знаний»

agent_<slug>

вопрос агенту компании, ответ текстом; TRX списываются, как за ответ агента в чате

В списке: агенты, видимые сотруднику; у ключа компании - при «Агенты компании»

confirm_action

выполнить (decision: run) или отменить (cancel) своё действие по номеру

В списке: личный ключ и функция политики «Подтверждать из внешних клиентов»

Документы баз знаний доступны и как ресурсы MCP: trialix://kb/<база>/<документ>, методы resources/list и resources/read.

Запись - только после подтверждения

Вызов инструмента записи ничего не меняет в системе: Trialix создаёт действие с номером и ссылкой, клиент получает ответ «Действие НЕ выполнено: оно ждёт подтверждения». Выполнить или отменить действие можно в разделе «Ожидают подтверждения»: в портале - действия по личному ключу, в кабинете компании - по ключу компании. Срок - 24 часа. Подтверждение прямо из клиента (confirm_action) включает администратор функцией политики «Подтверждать из внешних клиентов», по умолчанию она выключена.

Личный ключ

Работает в пределах политики и лицензии сотрудника: те же системы, режимы чтения и записи, дневные лимиты, базы знаний и агенты, что в чате. Ключ выпускается в портале, раздел «Мой ключ», если политика разрешает функцию «Ключи API». У сотрудника без лицензии ключ не работает.

Ключ компании

Работает без сотрудника и видит только то, что администратор отметил в кабинете компании: «Разработчикам» › ключ › «Доступ по MCP». Там выбираются подключения компании (только чтение или чтение и запись с подтверждением), поиск по базам знаний (только открытые разделы) и агенты компании. Ключ с правами «Только чат» к серверу MCP не подключается.

Данные

Ответы систем обезличиваются так же, как перед зарубежной моделью в чате: ФИО, организации, реквизиты и контакты приходят метками вида [ФИО_1], а метки в аргументах следующих вызовов Trialix заменяет исходными значениями. Доступы подключений наружу не отдаются. Ответ инструмента - до 12 000 знаков.

Журнал и лимиты

Каждый вызов записывается в журнал компании, обращения к системам видны на странице подключения в кабинете компании с пометкой «внешний клиент». Лимиты запросов в минуту действуют отдельно по ключу и по компании. Отзыв ключа сразу закрывает все сессии клиентов, после 20 отказов подряд по ключу администраторы получают письмо.

Цена

Доступ по MCP входит во все тарифы компаний. Отдельной цены за вызов нет: обращения к системам считаются действиями подключений, как в чате. TRX списываются только за работу моделей: ответы агентов и поиск по базе знаний. В кабинете «Модели» по личному ключу доступны личные подключения и агенты.

Сессии, ошибки, ресурсы и ограничения ключей подробно - в документе Сервер MCP Trialix.

Документы

Матрица совместимости, сервер MCP и шаблоны

С какими инструментами совместим api.trialix.ru, как подключить Trialix к Cursor и Claude Code и как подключить свою систему к модели через MCP.

Матрица совместимости публичного API

С чем совместим api.trialix.ru: Claude Code, Codex CLI, aider, Cursor, Cline, Continue, JetBrains, LibreChat, Open WebUI, Dify, n8n, PR-Agent, 1С, Битрикс24 и SDK.

Модели в API: российские модели и снятые с продаж

Российские модели и снятые с продаж модели в API: идентификаторы, псевдонимы, страна обработки данных, преемники.

Сервер MCP Trialix

Trialix как сервер MCP для Cursor, Claude Code, Claude Desktop и SDK: настройка клиентов, инструменты, подтверждение записи, ключи и данные.

Шаблоны MCP-сервера для Trialix

Как обернуть свою систему в MCP-сервер и подключить к Trialix: устройство шаблона, чтение и запись, публикация.

MCP-сервер на Python

Шаблон MCP-сервера на Python: официальный SDK mcp, FastMCP, Streamable HTTP, токен.

MCP-сервер на Node.js

Шаблон MCP-сервера на Node.js и TypeScript: официальный SDK @modelcontextprotocol/sdk.

Готовые конфиги для Claude Code, Cursor, Cline, Continue, JetBrains AI Assistant, Codex CLI, aider, LibreChat, Open WebUI, Dify, n8n, PR-Agent, 1С, Битрикс24 и SDK - в портале, раздел «Разработчикам» (нужен вход). Подключение систем компании к модели - в разделе Интеграции.