Подключение инструментов

Адрес для OpenAI SDK и любых клиентов, которые просят «OpenAI-compatible endpoint». Ключ передаётся в заголовке Authorization: Bearer.

https://visnea-labs.com/v1

• Chat Completions — стриминг (stream: true), вызов инструментов и картинки во входе.
• Responses — протокол, на котором работает Codex.
• Список моделей: поле data — чат-модели для клиентов, models — весь каталог с ценами.

curl https://visnea-labs.com/v1/chat/completions \  -H "Authorization: Bearer $VISNEA_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "model": "google-gemini-3-1-pro", "stream": true,        "messages": [{ "role": "user", "content": "Привет!" }] }'

# pip install openaiimport osfrom openai import OpenAIclient = OpenAI(    base_url="https://visnea-labs.com/v1",    api_key=os.environ["VISNEA_API_KEY"],)stream = client.chat.completions.create(    model="google-gemini-3-1-pro",    messages=[{"role": "user", "content": "Привет! Расскажи, что ты умеешь."}],    stream=True,)for chunk in stream:    if chunk.choices:        print(chunk.choices[0].delta.content or "", end="", flush=True)

Адрес для Anthropic SDK, Claude Code и Claude Desktop. Ключ — в x-api-key или Authorization: Bearer, заголовок anthropic-version передавайте как обычно.

https://visnea-labs.com/v1/anthropic

• Messages — стриминг, инструменты и кэш промптов (cache_control).
• count_tokens — подсчёт токенов до запроса.
• Список моделей Claude в формате Anthropic — по нему клиенты заполняют выбор модели.

curl https://visnea-labs.com/v1/anthropic/v1/messages \  -H "x-api-key: $VISNEA_API_KEY" \  -H "anthropic-version: 2023-06-01" \  -H "Content-Type: application/json" \  -d '{ "model": "anthropic-claude-sonnet-4-6", "max_tokens": 1024,        "messages": [{ "role": "user", "content": "Привет!" }] }'

# pip install anthropicimport osimport anthropicclient = anthropic.Anthropic(    base_url="https://visnea-labs.com/v1/anthropic",    api_key=os.environ["VISNEA_API_KEY"],)message = client.messages.create(    model="anthropic-claude-sonnet-4-6",    max_tokens=1024,    messages=[{"role": "user", "content": "Привет! Расскажи, что ты умеешь."}],)print(message.content[0].text)

Протокол зависит от модели: Claude отвечает через Anthropic Messages, новые модели OpenAI — через Responses, остальные — через Chat Completions. Какие эндпоинты есть у модели и умеет ли она инструменты, видно в кабинете: API → Модели. Агентам — Claude Code, Codex, OpenCode, Hermes, Grok CLI — нужны модели с инструментами.

Везде одно и то же: адрес Visnea, ключ sk-visnea-… и id модели. В кабинете, в разделе API → Подключение, эти шаги заполняются вашими моделями сами.

Claude CodeАгент в терминале через Anthropic Messages.Claude DesktopЧат, Cowork и Code через шлюз в настройках.CodexCLI, приложение и IDE через Responses.OpenCodeОткрытый агент через Chat Completions или Messages.Grok CLIАгент в терминале через Chat Completions.HermesАгент Nous Research, любой из протоколов.Cherry StudioДесктоп-клиент: провайдер OpenAI или Anthropic.

1. 1

   Установите Claude Code

   curl -fsSL https://claude.ai/install.sh | bash# илиnpm install -g @anthropic-ai/claude-code

2. 2

   Направьте его в Visnea

   Claude Code говорит на Anthropic Messages — меняем только адрес и ключ.

   export ANTHROPIC_BASE_URL="https://visnea-labs.com/v1/anthropic"export ANTHROPIC_AUTH_TOKEN="sk-visnea-…"export ANTHROPIC_MODEL="anthropic-claude-sonnet-4-6"export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic-claude-haiku-4-5"export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

   ANTHROPIC_DEFAULT_HAIKU_MODEL — быстрая модель для фоновых задач (заголовки, сводки). Последняя строка добавляет модели Visnea в команду /model.

3. 3

   Или один раз — в ~/.claude/settings.json

   {  "env": {    "ANTHROPIC_BASE_URL": "https://visnea-labs.com/v1/anthropic",    "ANTHROPIC_AUTH_TOKEN": "sk-visnea-…",    "ANTHROPIC_MODEL": "anthropic-claude-sonnet-4-6",    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic-claude-haiku-4-5",    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"  }}

4. 4

   Запустите

   claude# или без интерактиваclaude -p "Привет! Расскажи, что ты умеешь."

   Команда /status покажет адрес Visnea. Запросы появятся во вкладке «Аналитика» через пару секунд.

1. 1

   Включите режим разработчика

   Help → Troubleshooting → Enable Developer Mode. Приложение перезапустится с меню Developer.

2. 2

   Подключите Visnea как шлюз

   Developer → Configure Third-Party Inference… В разделе Connection выберите Inference provider: Gateway и заполните поля:

   Gateway base URL      https://visnea-labs.com/v1/anthropicGateway API key       sk-visnea-…Gateway auth scheme   Bearer

   Схема x-api-key тоже работает — Visnea принимает ключ в обоих заголовках.

3. 3

   Примените

   Apply Changes — приложение перезапустится. На экране входа продолжите без аккаунта Anthropic: чат, Cowork и вкладка Code пойдут через Visnea и спишутся с вашего баланса.

   Модели Claude приложение подтянет из Visnea само — например, anthropic-claude-sonnet-4-6.

1. 1

   Установите Codex CLI

   npm install -g @openai/codex

2. 2

   Сохраните ключ в окружении

   export VISNEA_API_KEY="sk-visnea-…"

   Windows (PowerShell): $env:VISNEA_API_KEY = "sk-visnea-…"

3. 3

   Добавьте провайдера в ~/.codex/config.toml

   model = "openai-gpt-5-5"model_provider = "visnea"[model_providers.visnea]name = "Visnea"base_url = "https://visnea-labs.com/v1"env_key = "VISNEA_API_KEY"wire_api = "responses"

4. 4

   Запустите

   codex# или без интерактиваcodex exec "Привет! Расскажи, что ты умеешь."

5. 5

   Приложение Codex и расширение для IDE

   Читают тот же ~/.codex/config.toml — перезапустите их после правки.

   # macOS: чтобы приложение видело ключlaunchctl setenv VISNEA_API_KEY "sk-visnea-…"

   Приложения, открытые не из терминала, не видят переменные из ~/.zshrc. На Windows задайте VISNEA_API_KEY в «Переменных среды» и перезапустите приложение.

1. 1

   Установите OpenCode

   curl -fsSL https://opencode.ai/install | bash# илиnpm install -g opencode-ai

2. 2

   Сохраните ключ в окружении

   export VISNEA_API_KEY="sk-visnea-…"

   Windows (PowerShell): $env:VISNEA_API_KEY = "sk-visnea-…"

3. 3

   Добавьте провайдера в opencode.json

   Файл в корне проекта или глобально — ~/.config/opencode/opencode.json.

   {  "$schema": "https://opencode.ai/config.json",  "provider": {    "visnea": {      "npm": "@ai-sdk/openai-compatible",      "name": "Visnea",      "options": {        "baseURL": "https://visnea-labs.com/v1",        "apiKey": "{env:VISNEA_API_KEY}"      },      "models": {        "google-gemini-3-1-pro": {          "name": "Gemini 3.1 Pro"        }      }    }  },  "model": "visnea/google-gemini-3-1-pro"}

   Модели Claude подключайте вторым провайдером: @ai-sdk/anthropic с адресом …/v1/anthropic/v1.

4. 4

   Запустите

   opencode

   Сменить модель — команда /models.

1. 1

   Установите Grok CLI

   curl -fsSL https://raw.githubusercontent.com/superagent-ai/grok-cli/main/install.sh | bash

2. 2

   Направьте его в Visnea

   Grok CLI ходит в OpenAI-совместимый Chat Completions — подходит любая модель с инструментами.

   export GROK_BASE_URL="https://visnea-labs.com/v1"export GROK_API_KEY="sk-visnea-…"export GROK_MODEL="google-gemini-3-1-pro"

   Чтобы не задавать каждый раз, допишите строки в ~/.zshrc или ~/.bashrc.

3. 3

   Запустите

   grok# или без интерактиваgrok -p "Привет! Расскажи, что ты умеешь."

1. 1

   Установите Hermes Agent

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

2. 2

   Сохраните ключ в окружении

   export VISNEA_API_KEY="sk-visnea-…"

   Windows (PowerShell): $env:VISNEA_API_KEY = "sk-visnea-…"

3. 3

   Добавьте Visnea в ~/.hermes/config.yaml

   Или интерактивно: hermes model → Custom endpoint, затем адрес, ключ и модель.

   model:  default: google-gemini-3-1-pro  provider: custom  base_url: https://visnea-labs.com/v1  key_env: VISNEA_API_KEY

4. 4

   Запустите

   hermes

   Сменить модель — команда /model.

1. 1

   Добавьте провайдера

   Settings → Model Provider → + Add: имя Visnea, тип OpenAI.

2. 2

   Вставьте ключ и адрес

   API Key       sk-visnea-…API Address   https://visnea-labs.com

   Путь /v1/chat/completions Cherry Studio допишет сам. Для моделей Claude заведите второго провайдера с типом Anthropic и адресом …/v1/anthropic.

3. 3

   Добавьте модели

   Manage → получите список моделей и нажмите + у нужных, например google-gemini-3-1-pro. Кнопка Check проверит ключ.