SDK и клиенты | GateYourWay API

01

Файл для вашего приложения

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

Приложение Модель и группа

Ваш API-ключПоказать ключ

Операционная система

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

1. Куда положить
Зависимость SDK
2. Запустить заново

Формат конфигурации: . Не подключается?

02

Сохранить и проверить

Если файл уже существует, сделайте его копию и объедините настройки. Не заменяйте другие providers, MCP, hooks и разрешения. Новый файл не должен называться settings (1).json.
Windows: вставьте указанный путь папки в адресную строку Проводника. %USERPROFILE% откроет вашу домашнюю папку. Включите «Расширения имён файлов»: нужен settings.json, не settings.json.txt. Для JSON используйте UTF-8 без комментариев и лишней запятой.
Замените gyw-sk-YOUR_KEY полным ключом, если не вставили его выше. Закройте старую сессию клиента и откройте новую. Отправьте «Ответь OK», затем попросите прочитать небольшой тестовый файл и назвать его содержимое.
В истории запросов проверьте модель и результат. Работа текстового запроса ещё не проверяет инструменты, изображения или длинные документы.

03

Claude Code: settings.json

Пример для Fable 5. Для другой модели скачайте файл выше.

settings.json

{
  "model": "claude-fable-5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gateyourway.com",
    "ANTHROPIC_AUTH_TOKEN": "gyw-sk-YOUR_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "claude-fable-5"
  }
}

"env" здесь является разделом файла Claude Code, а не отдельным .env-файлом. В нём ключ задан через ANTHROPIC_AUTH_TOKEN; пустой ANTHROPIC_API_KEY убирает конкурирующий способ авторизации.

После перезапуска проверьте /status и /model. Если модель или ключ другие, проверьте .claude/settings.json и .claude/settings.local.json внутри проекта: они имеют приоритет над пользовательским файлом. Флаг --model также меняет выбранную модель. Официальная схема и приоритет настроек.

04

SDK

Python и JavaScript с готовым запросом доступны в списке приложений выше.

python

from openai import OpenAI

client = OpenAI(
    api_key="gyw-sk-YOUR_KEY",
    base_url="https://api.gateyourway.com/v1",
)
response = client.responses.create(model="gpt-5.6-luna", input="Reply OK")
print(response.output_text)

python

import anthropic

client = anthropic.Anthropic(
    api_key="gyw-sk-YOUR_KEY",
    base_url="https://api.gateyourway.com",
)
message = client.messages.create(
    model="claude-fable-5", max_tokens=256,
    messages=[{"role": "user", "content": "Reply OK"}],
)
print(message.content)

settings

OpenAI Base URL: https://api.gateyourway.com/v1/cursor
API key: gyw-sk-YOUR_KEY
Custom model: gyw-opus-5

toml

model = "gpt-5.6-luna"
model_provider = "gateyourway"

[model_providers.gateyourway]
name = "GateYourWay"
base_url = "https://api.gateyourway.com/v1"
wire_api = "responses"
experimental_bearer_token = "gyw-sk-YOUR_KEY"

05

Какой файл и адрес

Клиент	Protocol / base URL	Примечание
Claude Code	`https://api.gateyourway.com`	`~/.claude/settings.json`
OpenCode / Claude	`https://api.gateyourway.com/v1`	`@ai-sdk/anthropic`
OpenCode / GPT, Grok	`https://api.gateyourway.com/v1`	`@ai-sdk/openai-compatible`
Cursor / Opus 5	`https://api.gateyourway.com/v1/cursor`	`gyw-opus-5`; Claude Arctic key
Cursor / GLM 5.3 Flash	`https://api.gateyourway.com/v1`	`glm-5.3-flash`; GLM 5.3 Flash key
Codex CLI	`https://api.gateyourway.com/v1`	`wire_api = "responses"`
CC Switch	Настройки выбранного приложения	Менеджер настроек, не отдельная модель. Реальный запрос выполняет Claude Code или Codex.
Pi	`~/.pi/agent/models.json`	`openai-responses`, `openai-completions` или `anthropic-messages`
oh-my-pi	`~/.omp/agent/models.yml`	Отдельная YAML-схема; не используйте конфиг Pi.
Roo Code	OpenAI Compatible или Anthropic	Укажите custom base URL и точный model ID.
Cline	OpenAI Compatible или Anthropic	Проверьте соединение до запуска agent task.

06

Если не подключается

Симптом	Проверка
401 / Invalid or revoked key	Проверьте полный ключ без кавычек, пробелов и Bearer. Сверьте адрес и настройки проекта/профиля. В Claude Code не оставляйте разные ключи в AUTH_TOKEN и API_KEY. Код 401 не доказывает, что именно задуманный вами ключ был отправлен.
403	Ключ распознан, но доступ запрещён. Сверьте группу ключа и модели в кабинете; одинаковый model ID может предлагаться в разных группах.
402	Проверьте доступный баланс для группы ключа.
Codex: Missing environment variable	Старый provider всё ещё содержит env_key. В файловом варианте используйте только experimental_bearer_token внутри [model_providers.gateyourway]; не смешивайте его с env_key или auth.
Cursor + Opus 404 / model missing	Для Opus bridge проверьте `/v1/cursor` и model ID `gyw-opus-5`.
Cursor + GLM 404 / model missing	Для GLM нужен `https://api.gateyourway.com/v1` и `glm-5.3-flash`. Не используйте Opus bridge `/v1/cursor`.
OpenCode 404 / provider error	Используйте `/v1`, `claude-opus-5` и `@ai-sdk/anthropic`.
Изображение не дошло	Проверьте `attachment: true`, image modality и реальный attachment preview.
Первый turn работает, второй зависает	Сохраните время, версию клиента, request ID и последние 6 символов ключа; не передавайте полный ключ.
502 / 503 / 504	Сохраните HTTP-код, время с часовым поясом и request ID. Не меняйте модель и ключ наугад. Не повторяйте автоматически запрос, если полезная часть ответа уже пришла.