VynarisРанняя бетаПолучить API-ключ

Документация

Направьте своего агента на один эндпоинт.

Vynaris — совместимый с OpenAI шлюз chat completions по адресу https://api.vynaris.com/v1. Замените base URL в уже используемом клиенте, сохраните свои промпты и определения инструментов и читайте квитанцию в каждом ответе.

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

Три шага.

01

Получите ключ

Войдите на app.vynaris.com/signin and copy your key. It looks like vyn_sk_live_… and is shown once, at creation — save it somewhere safe.

02

Настройте base URL

Укажите в base_url клиента адрес https://api.vynaris.com/v1 (для клиентов в формате OpenAI) или https://api.vynaris.com (Anthropic SDK). Nothing else in your stack changes.

03

Отправьте запрос

Установите для model значение auto and let the router pick, or send a frontier model name and it gets right-sized with a receipt.

Во всех фрагментах ниже используется ключ-заполнитель vyn_sk_live_XXXX. Real keys come from your dashboard’s API keys page.

Harness

curl

Самый прямой вариант интеграции — удобен, чтобы проверить ключ до подключения SDK.

curl
curl https://api.vynaris.com/v1/chat/completions \
  -H "Authorization: Bearer vyn_sk_live_XXXX" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Say hi in five words."}]}'

Harness

OpenAI SDK (Python)

Измените base_url и api_key; every other call in your codebase is unchanged.

openai_client.py
from openai import OpenAI

client = OpenAI(base_url="https://api.vynaris.com/v1", api_key="vyn_sk_live_XXXX")
resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Say hi in five words."}],
)
print(resp.choices[0].message.content)

Harness

OpenAI SDK (TypeScript)

Same swap in the TypeScript client — set baseURL и apiKey при создании клиента.

openai-client.ts
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.vynaris.com/v1",
  apiKey: "vyn_sk_live_XXXX",
});

const resp = await client.chat.completions.create({
  model: "auto",
  messages: [{ role: "user", content: "Say hi in five words." }],
});
console.log(resp.choices[0].message.content);

Harness

Anthropic SDK (Python)

Anthropic SDK работает с base_url=https://api.vynaris.com при создании клиента, показанном ниже. Note: Vynaris’s native /v1/messages wire format is not yet implemented — route Anthropic-shaped traffic through the OpenAI-compatible /v1/chat/completions endpoint documented above until that lands.

anthropic_client.py
import anthropic

client = anthropic.Anthropic(base_url="https://api.vynaris.com", auth_token="vyn_sk_live_XXXX")
msg = client.messages.create(
    model="auto", max_tokens=64,
    messages=[{"role": "user", "content": "Say hi in five words."}],
)
print(msg.content)

Harness

Claude Code

Claude Code берёт свой эндпоинт из переменных окружения. Это подключает его к Vynaris для текущей сессии shell; поскольку /v1/messages is not yet implemented, treat this as environment setup for future compatibility rather than a guarantee that every Claude Code call is served today.

shell
export ANTHROPIC_BASE_URL=https://api.vynaris.com
export ANTHROPIC_AUTH_TOKEN=vyn_sk_live_XXXX
claude

Harness

Cursor

Добавьте Vynaris как пользовательского провайдера, совместимого с OpenAI, в настройках моделей Cursor.

настройки Cursor
# Cursor → Settings → Models → API keys
#   OpenAI API key:       vyn_sk_live_XXXX
#   Override base URL:    https://api.vynaris.com/v1
# Then pick any model and send a chat message.

Harness

Hermes (hermes-agent)

hermes-agent от NousResearch использует именованные пользовательские провайдеры в ~/.hermes/config.yaml — note that OPENAI_BASE_URL does not apply to custom providers, and keys belong in an env var via key_env, never in the file. Switch models at runtime with /model custom:vynaris:auto.

~/.hermes/config.yaml + shell
# Hermes (NousResearch hermes-agent) — add Vynaris as a custom provider.
# Note: OPENAI_BASE_URL does NOT apply to custom providers; use config.yaml.

# ~/.hermes/config.yaml
custom_providers:
  - name: vynaris
    base_url: https://api.vynaris.com/v1
    key_env: VYNARIS_KEY          # keys never live in config.yaml
    api_mode: chat_completions

model:
  default: custom:vynaris:auto     # or /model custom:vynaris:auto at runtime

# shell
export VYNARIS_KEY=vyn_sk_live_XXXX
hermes --tui

Harness

OpenClaw

Добавьте Vynaris как пользовательского провайдера в ~/.openclaw/openclaw.json with "api": "openai-completions", then select vynaris/auto as your model.

~/.openclaw/openclaw.json
// OpenClaw → add Vynaris as a custom provider
// (~/.openclaw/openclaw.json, then pick "vynaris/auto" as your model)
{
  "models": {
    "providers": {
      "vynaris": {
        "baseUrl": "https://api.vynaris.com/v1",
        "apiKey": "vyn_sk_live_XXXX",
        "api": "openai-completions",
        "models": [{ "id": "auto", "name": "Vynaris auto-route" }]
      }
    }
  }
}

Harness

Агент для программирования Pi

Pi (badlogic/pi-mono) считывает пользовательских провайдеров из ~/.pi/agent/models.json, hot-reloaded when you open /model. Use a distinct key env var: Pi’s precedence rules let OPENAI_API_KEY незаметно переопределять ключи из файла конфигурации. Для любого другого harness: укажите base URL и ключ там, где настраивается провайдер, затем проверьте через /v1/ping.

~/.pi/agent/models.json
// Pi coding agent (badlogic/pi-mono) — ~/.pi/agent/models.json
// Reloads automatically when you open /model — no restart needed.
{
  "providers": {
    "vynaris": {
      "baseUrl": "https://api.vynaris.com/v1",
      "api": "openai-completions",
      "apiKey": "$VYNARIS_KEY",
      "models": [
        { "id": "auto", "name": "Vynaris Auto",
          "input": ["text"], "contextWindow": 128000, "maxTokens": 16384 }
      ]
    }
  }
}

// shell — use a distinct env name: Pi lets OPENAI_API_KEY override
// models.json keys, so don't reuse it for Vynaris.
// export VYNARIS_KEY=vyn_sk_live_XXXX
// then pick the model via /model → vynaris → auto

Размещённые Vynaris модели

Выбирайте модель с пониженным числом отказов для каждого запроса.

Используйте обычный совместимый с OpenAI эндпоинт chat completions и укажите один из точных идентификаторов ниже в model. Такие запросы обходят автоматический выбор модели. Премиальные тарифы за гарантированную анонимность и защиту данных.

запрос к размещённой модели
curl https://api.vynaris.com/v1/chat/completions \
  -H "Authorization: Bearer vyn_sk_live_XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vynaris/qwen3.6-35b-a3b-uncensored",
    "messages": [{"role":"user","content":"Review this authorized test plan..."}],
    "stream": true
  }'

Первый запрос после периода простоя может выполняться дольше, пока запускаются приватные мощности и загружаются веса модели. Параллельные запросы используют общую очередь мощностей; не создавайте отдельный worker для каждого конечного пользователя. Тела промптов и ответов никогда не сохраняются для этих четырёх идентификаторов модели, даже если для API-ключа включён захват транскриптов. Метаданные биллинга — модель, аккаунт, количество токенов, цена, задержка, статус и идентификатор запроса — сохраняются.

Используйте только для законной и разрешённой работы. Запрещены сексуальная эксплуатация детей, торговля людьми или их эксплуатация, а также сексуальный контент без согласия. Тестируйте только системы и данные, которые принадлежат вам или на оценку которых вы уполномочены. Compare model cards and tradeoffs →

Как читать квитанцию

Каждый ответ содержит собственную квитанцию.

В каждом теле ответа есть блок vynaris, а те же сведения возвращаются в заголовках ответа x-vynaris-*, так что их можно прочитать без разбора тела.

тело ответа (фрагмент)
{
  "id": "chatcmpl-8f2a91",
  "choices": [ { "message": { "role": "assistant", "content": "..." } } ],
  "vynaris": {
    "request_id": "req_8f2a91",
    "requested_model": "gpt-4o",
    "served_model": "qwen3-8b-ft",
    "cost_usd": "0.000418",
    "direct_equivalent_usd": "0.01820000"
  }
}
заголовки ответа
x-vynaris-request-id: req_8f2a91
x-vynaris-served-model: qwen3-8b-ft
x-vynaris-cost-usd: 0.000418
x-vynaris-baseline-usd: 0.0182
x-vynaris-saved: 98%

direct_equivalent_usd — это стоимость requested_model would have cost at list price for the same tokens — the number the savings percentage is computed from.

Ошибки

Что может пойти не так и как это исправить.

401 — нет авторизации

Ключ отсутствует, имеет неверный формат или отозван. В сообщении об ошибке указана конкретная проблема (например, «key revoked» вместо «no key provided»), а не общая ошибка аутентификации.

402 — недостаточно кредитов

Your balance (or this key’s spend cap) hit zero, or a hosted uncensored model was called by an account that is not on the $50 L or $150 XL plan. Nothing was sent upstream and nothing was charged. Hosted-model access responses use code hosted_model_plan_required. This is terminal for the request — do not retry it. Top up or raise the key’s cap, then send a new request.

502 — ошибка провайдера

Провайдер обслуживающей модели завершился с ошибкой или превысил время ожидания. За неудачный вызов провайдера плата не взимается. Запрос можно повторить.

Paying with Monero

Fund your balance in XMR, privately.

Vynaris is the only AI API you can pay for in Monero that refunds bad answers. Pay with Monero for complete payment privacy: no card, no name, no billing address, and no payment processor between you and our wallet.

API баланса и потребления

Запрашивайте баланс и историю запросов.

Both endpoints take the same Authorization: Bearer для генерации ответа в чате.

проверить ключ
curl https://api.vynaris.com/v1/ping -H "Authorization: Bearer vyn_sk_live_XXXX"
проверить баланс и потребление
curl https://api.vynaris.com/v1/usage -H "Authorization: Bearer vyn_sk_live_XXXX"
получить журнал операций
curl https://api.vynaris.com/v1/ledger -H "Authorization: Bearer vyn_sk_live_XXXX"