К содержимому

APIWAY / Настройка Base URL, ключа и AI-клиента

Настройте адрес. Подключите инструмент.

Найдите свой клиент: Cline, редактор, терминал или скрипт. Сопоставьте Base URL, ключ и Model ID; проверьте формат запроса и возможные ошибки.

BASE URL
https://api.apiway.ru/v1
API-КЛЮЧСоздать ключ в кабинете ↗Отдельный ключ для каждого приложения
MODEL ID
gpt-5.6-luna
Проверить каталог →

В примере — gpt-5.6-luna. Ранее проверялись текстовый и потоковый запросы; это не гарантия текущего ответа. Сверьте статус в каталоге. Запросы расходуют баланс. Функции инструментов и агентные сценарии проверяются отдельно.

Подставить свой ключ в примеры

Ключ не отправляется и не сохраняется страницей — подстановка происходит локально в вашем браузере

ВЫБОР ИНСТРУМЕНТА

С чего хотите начать?

24 инструмента · одна инструкция за раз

Для терминала
curl / BashЗапрос

Первый запрос из терминала. Подходит для Bash в Linux, macOS или WSL.

  1. Введите ключ без отображения на экране. Переменная живёт только в текущем окружении терминала.
  2. Выполните запрос ниже. -i показывает HTTP-статус вместе с ответом; -sS сохраняет сообщения о сетевых ошибках.
  3. При успехе найдите choices[0].message.content. При ошибке смотрите статус и её сообщение.
Подготовка
read -rsp "API-ключ: " APIWAY_API_KEY; printf '\n'
export APIWAY_API_KEY
Пример запроса
curl -i -sS --max-time 60 \
  https://api.apiway.ru/v1/chat/completions \
  -H "Authorization: Bearer $APIWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"Привет! Ответь одним предложением."}]}'

Это синтаксис Bash. В PowerShell используйте отдельный пример ниже. Перед запросом проверьте подключение модели и баланс.

Windows / PowerShell 7Запрос

Запрос через Invoke-RestMethod, без различий между curl и его shell-алиасами.

  1. Откройте PowerShell 7. Введите ключ через маскированный ввод; пример не сохраняет его постоянно.
  2. Выполните код. JSON формируется из объекта, поэтому вручную экранировать кавычки не нужно.
  3. Смотрите текст ответа. При ошибке терминал покажет статус запроса; не публикуйте заголовки с ключом.
Подготовка
$env:APIWAY_API_KEY = Read-Host 'API-ключ' -MaskInput
Пример запроса
$payload = @{
  model = 'gpt-5.6-luna'
  messages = @(
    @{ role = 'user'; content = 'Привет!' }
  )
} | ConvertTo-Json -Depth 5

$params = @{
  Uri = 'https://api.apiway.ru/v1/chat/completions'
  Method = 'Post'
  Headers = @{ Authorization = "Bearer $env:APIWAY_API_KEY" }
  ContentType = 'application/json; charset=utf-8'
  Body = [System.Text.Encoding]::UTF8.GetBytes($payload)
  TimeoutSec = 60
}
$result = Invoke-RestMethod @params
$result.choices[0].message.content
$result.usage

Маскированный Read-Host в этом примере рассчитан на PowerShell 7, а не встроенный Windows PowerShell 5.1.

Python / OpenAI SDKКод

Текстовый запрос с заданным base URL, явным тайм-аутом и без автоматических повторов.

  1. Установите библиотеку командой ниже.
  2. Задайте APIWAY_API_KEY в окружении: используйте блок Bash или PowerShell на этой странице.
  3. Сохраните код в request.py и выполните python request.py.
Подготовка
python -m pip install openai
Пример запроса
import os
from openai import OpenAI, APIStatusError, APIConnectionError

client = OpenAI(
    api_key=os.environ["APIWAY_API_KEY"],
    base_url="https://api.apiway.ru/v1",
    timeout=60.0,
    max_retries=0,
)

try:
    result = client.chat.completions.create(
        model="gpt-5.6-luna",
        messages=[{"role": "user", "content": "Привет!"}],
    )
    print(result.choices[0].message.content)
    if result.usage:
        print("Usage:", result.usage.model_dump())
except APIStatusError as error:
    print("HTTP-ошибка:", error.status_code)
except APIConnectionError:
    print("Не удалось получить ответ: проверьте сеть и тайм-аут.")

Отсутствие usage в ответе не доказывает нулевой расход. Проверяйте историю кабинета. Пример не включает streaming и tools.

JavaScript / Node.jsКод

Обычный fetch на сервере. Нужен Node.js 22 или новее; дополнительный SDK не требуется.

  1. Задайте ключ в переменной APIWAY_API_KEY до запуска Node.js.
  2. Сохраните код в request.mjs и выполните node request.mjs.
  3. Ответ выводится в терминал. Такой код нельзя переносить в публичный браузерный скрипт вместе с ключом.
Пример запроса
const key = process.env.APIWAY_API_KEY;
if (!key) throw new Error("Задайте APIWAY_API_KEY");

const response = await fetch(
  "https://api.apiway.ru/v1/chat/completions",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer " + key,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "gpt-5.6-luna",
      messages: [{ role: "user", content: "Привет!" }],
    }),
    signal: AbortSignal.timeout(60000),
  },
);
if (!response.ok) {
  throw new Error("HTTP " + response.status);
}
const result = await response.json();
console.log(result.choices?.[0]?.message?.content);
console.log("Usage:", result.usage ?? "не передан");

API-ключ хранится на вашем сервере. Для приложения с пользователями нужен свой серверный обработчик, ограничение доступа и учёт запросов.

n8n / HTTP RequestHTTP-узел

Начните с обычного HTTP-узла: он не требует агентного режима или вызова инструментов.

  1. Создайте HTTP Request. Method: POST. URL: https://api.apiway.ru/v1/chat/completions.
  2. Authentication: Generic Credential Type → Header Auth. Создайте credential с Name: Authorization и Value: Bearer + пробел + ваш API-ключ.
  3. Включите Send Body. Body Content Type: JSON; задайте тело из примера. Не размещайте ключ в JSON workflow.
  4. Запустите один узел вручную. Ответ — choices[0].message.content. После проверки передайте это поле следующему узлу.
JSON
{
  "model": "gpt-5.6-luna",
  "messages": [
    {"role": "user", "content": "Составь краткий план письма клиенту"}
  ]
}

Настройка HTTP Request не подтверждает совместимость маршрута с AI Agent или OpenAI-узлом, использующим Responses API.

VS Code / ClineНастройка

Настройте собственный OpenAI-совместимый провайдер в Cline. Результат зависит от возможностей модели.

  1. В установленном Cline откройте Settings. API Provider: OpenAI Compatible.
  2. Base URL: https://api.apiway.ru/v1. API Key: отдельный ключ из кабинета. Model ID: gpt-5.6-luna.
  3. Не включайте поддержку изображений и не задавайте выдуманные размеры контекста. Используйте только подтверждённые возможности выбранной модели.
  4. Сначала проверьте короткую текстовую задачу. Если клиент требует tools, streaming или другой протокол, одного успешного curl-запроса недостаточно.

Работа агентного сценария Cline на текущем бесплатном миксе отдельно не подтверждена. Не используйте обычный ключ как вход в аккаунт OpenAI.

ContinueНастройка

Собственный провайдер в Continue: базовый адрес, точный ID и отдельный ключ.

  1. Откройте конфигурацию Continue. Добавьте модель в существующий models; не создавайте второй одноимённый раздел.
  2. Укажите provider: openai, apiBase: https://api.apiway.ru/v1, model: gpt-5.6-luna и свой apiKey через поддерживаемое хранилище секретов клиента.
  3. Если клиент выбирает Responses автоматически, используйте useResponsesApi: false для Chat Completions.
  4. Начните с обычного чата. Агентные функции требуют отдельной проверки tools и streaming.

Названия настроек зависят от версии. Конфиг с ключом не публикуйте.

JetBrains / IDEНастройка

Для Rider, IDEA, PyCharm и WebStorm используйте клиент с настройкой своего провайдера.

  1. Проверьте наличие собственного OpenAI-compatible провайдера в вашей версии AI Assistant. Если его нет, рассмотрите Continue для JetBrains.
  2. В доступном провайдере задайте Base URL, API Key и точный ID модели из блока параметров.
  3. Проверьте обычный чат. Доступность провайдеров и функций зависит от версии IDE, плагина и подписки.

Здесь не обещается совместимость встроенного агента со всеми версиями IDE.

CursorНастройка

Подключение зависит от поддержки собственного OpenAI-совместимого адреса в вашей версии Cursor.

  1. Откройте настройки моделей и API-ключей. Проверьте наличие поля собственного Base URL; если поля нет, установите Cline в редакторе.
  2. Если свой адрес поддерживается, задайте параметры из блока выше и ID доступной модели.
  3. Начните с текстового чата. Встроенные модели, функции агента и подписка Cursor регулируются самим клиентом.

Сторонний API-ключ не включает подписку или все функции Cursor.

OpenCodeНастройка

Добавьте отдельного провайдера без изменения остальных моделей OpenCode.

  1. /connect → Other. Назовите провайдер custom_api и добавьте отдельный ключ из кабинета.
  2. Добавьте блок provider в существующий opencode.json. JSON ниже содержит только адрес и ID; секрет хранится в credentials OpenCode.
  3. В /models выберите custom_api/gpt-5.6-luna. Сначала проверьте простую задачу без инструментов.
JSON
{
  "provider": {
    "custom_api": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIWAY",
      "options": {
        "baseURL": "https://api.apiway.ru/v1"
      },
      "models": {
        "gpt-5.6-luna": {
          "name": "Тестовый маршрут"
        }
      }
    }
  }
}

Пакет openai-compatible использует Chat Completions. Полный агентный сценарий отдельно не подтверждён.

Codex AppТребования

Настольное приложение Codex. Для своего провайдера требуется Responses API.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат Responses API.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Codex CLIТребования

Codex использует Responses API. Текущий текстовый пример Chat Completions сам по себе не подтверждает подключение.

  1. Проверьте, что выбранный маршрут поддерживает Responses API и необходимые функции агента. Эта проверка для текущего микса ещё не завершена.
  2. В документации Codex собственный провайдер задаётся через model_providers; wire_api имеет значение responses. Конфигурацию с chat не используйте.
  3. До подтверждения маршрута начните с Python, curl или HTTP Request. Готовый конфиг Codex для этого микса здесь не публикуется.

Это справка о требованиях клиента, а не обещание готовой интеграции. Поддержку Responses и tools нужно проверять на конкретной модели.

Codex / VS CodeТребования

Расширение Codex использует требования провайдера Codex, а не обычный Chat Completions.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат Responses API.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Claude CodeТребования

Claude Code требует совместимого API-формата и возможностей маршрута; OpenAI-compatible chat не заменяет протокол Anthropic.

  1. Проверьте Anthropic-совместимый endpoint и доступную модель Claude, затем требования конкретной версии клиента.
  2. ANTHROPIC_BASE_URL указывает на сервис, но адрес не включает отсутствующую совместимость автоматически. Готовый конфиг APIWAY сейчас не подтверждён.
  3. Для первого запроса используйте обычные текстовые примеры. Отдельный гайд Claude Code добавим после проверки полного сценария.

Не подставляйте gpt-5.6-luna в настройку Claude Code как будто это проверенная модель Claude.

Claude AppТребования

У приложения Claude собственные способы входа и подключения. Ключ нашего сервиса не является подпиской Claude.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат совместимого подключения Claude.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Gemini CLIТребования

CLI Gemini: перед настройкой проверьте протокол и поддержку своего провайдера.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат поддерживаемого API клиента.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Grok BuildТребования

Проверьте возможность своего провайдера в конкретной версии Grok Build.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат поддерживаемого API клиента.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Kimi CodeТребования

Не путайте Kimi как модель в каталоге и Kimi Code как программу. Требования подключения различаются.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат поддерживаемого API клиента.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

DeepSeek HarnessТребования

Для агентной среды сначала проверьте формат провайдера и необходимые функции модели.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат поддерживаемого API клиента.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Hermes DesktopТребования

Если ваша версия Hermes поддерживает OpenAI-compatible провайдер, сопоставьте адрес, ключ и модель. Иначе используйте другой клиент.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат поддерживаемого API клиента.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

ZCodeТребования

В мастере собственного провайдера проверьте возможность выбора Chat Completions. Само наличие мастера не подтверждает работу текущего маршрута.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат Chat Completions.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Pi / coding agentТребования

Агент Pi: поддержка провайдера и нужных функций проверяется по вашей версии клиента.

  1. Проверьте, что ваша версия клиента поддерживает собственный провайдер и формат поддерживаемого API клиента.
  2. Сверьте формат выбранного маршрута в каталоге. Сначала выполните отдельный текстовый запрос через curl или PowerShell.
  3. Настраивайте клиент только после проверки нужного протокола и функций агента. Для выбранной модели готовое подключение не подтверждено.

Если клиент принимает только родной сервис, адрес OpenAI-compatible API не заменяет его протокол. Используйте Cline или прямой HTTP для первого знакомства.

Janitor AIНастройка

Если в вашем клиенте доступны настройки собственного прокси, используйте только поддерживаемый формат.

  1. Откройте настройки API или прокси в вашей версии клиента. Проверьте наличие собственного Chat Completions endpoint.
  2. Для поля Base URL используйте адрес с /v1. Для полного request URL используйте /v1/chat/completions.
  3. Задайте отдельный ключ и точный ID. Проверьте короткое сообщение; не передавайте чувствительные данные стороннему приложению.

Доступность настроек прокси и сохранение ключа регулирует сторонний клиент. Совместимость отдельно не подтверждена.

Другое приложениеПоля клиента

Если клиент поддерживает собственный OpenAI-совместимый сервис, сопоставьте три поля с нашим сервисом.

  1. Base URL: https://api.apiway.ru/v1. Если поле называется endpoint или request URL и ожидает полный путь, используйте https://api.apiway.ru/v1/chat/completions. Сверяйте назначение поля с документацией клиента.
  2. API Key: отдельный ключ из кабинета. Model или Model ID: gpt-5.6-luna, если этот маршрут доступен в текущем каталоге и разрешён ключу.
  3. Выберите формат Chat Completions, если клиент предлагает выбор протокола. Начните с обычного текстового сообщения.
  4. Проверьте ответ и историю расходов. Если приложение использует только Responses, Anthropic или требует tools/vision, совместимость проверяется отдельно.

Поля адреса и ключа — необходимая настройка, но не гарантия работы любого приложения. Подписка на сторонний клиент и его встроенные функции не включаются в доступ APIWAY.

Что считать успешным подключением?

Вы получили текст ответа. Затем проверьте историю запроса и учтённый объём в кабинете. Ошибку разбирайте по HTTP-коду.

Открыть историю →

Если запрос не прошёл

Документация API →
400Параметры запроса

Проверьте JSON, messages, точное название модели. Уберите необязательные параметры и начните с текстового примера.

401 / 403Доступ

Проверьте срок и статус ключа, заголовок Authorization, разрешённую модель. Пароль кабинета не заменяет API-ключ.

404Адрес или маршрут

Для SDK base URL заканчивается на /v1, для прямого HTTP — на /v1/chat/completions. Также проверьте доступность идентификатора модели.

429Лимит запросов

Снизьте частоту. Если ответ содержит Retry-After, учитывайте его. Не запускайте бесконечные повторы; действуют лимиты сервиса.

5xxСервис временно недоступен

Сохраните время, HTTP-статус и сообщение без секретов. Попробуйте позже; отсутствие ответа не всегда означает ошибку вашего кода.

Тайм-аутОтвет не получен

Проверьте сеть и лимит ожидания. Не повторяйте запрос автоматически, не разобравшись в результате и учёте: сервер мог успеть его обработать.

Подключение настроено?

Выберите маршрут и оцените расходы для своей задачи.

Каталог моделей →Калькулятор стоимости →