ИНСТРУКЦИИ · CODGEASS API

Подключите своё приложение.

От API-ключа до первого ответа. Выберите программу и систему — получите нужные адреса, команды и порядок настройки.

01 / ПОДГОТОВКА

Три вещи для подключения

  1. Клиентский API-ключ Codgeass. Используйте ключ, выданный при покупке доступа. Откройте личный кабинет и проверьте, что ключ активен, срок не истёк и есть доступный баланс.
  2. Адрес API. В поле Base URL укажите https://codgeass.ru/v1. Если приложение само дописывает /v1, в поле API Host нужен только https://codgeass.ru.
  3. Точный Model ID. Получите его из GET /v1/models по инструкции ниже. Название из рекламного каталога может отличаться от идентификатора API.
https://codgeass.ru/v1

В примерах стоит ВАШ_API_КЛЮЧ: замените его своим ключом на компьютере. Не отправляйте ключ в переписку и не публикуйте в репозитории.

02 / ВЫБЕРИТЕ НАСТРОЙКУ

Где будете работать?

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

На Windows для Codex, OpenCode и aider есть автоматическая настройка через PowerShell. Выбор сохраняется в ссылке — её можно добавить в закладки.

04 / ПОМОЩЬ

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

401 · Неверный API-ключ

Скопируйте ключ полностью, уберите пробелы и переносы строк. В поле API Key вставляйте только ключ; слово Bearer нужно в HTTP-заголовке, но обычно не нужно в настройках приложения. Проверьте этот же ключ в кабинете Codgeass.

402 / 403 · Баланс, срок или доступ

Посмотрите статус, остаток, срок действия и ограничения в кабинете. У ключа может быть доступ только к определённым моделям. Получите список /v1/models заново. При недостаточном балансе уменьшите контекст и лимит ответа или обратитесь к продавцу для пополнения.

404 · Не найден адрес или модель

Проверьте, что запрос идёт на codgeass.ru, а /v1 встречается ровно один раз. Model ID должен совпадать с ответом /v1/models, включая регистр, дефисы и точки. Наличие модели в списке не гарантирует поддержку каждого API-протокола.

429 · Слишком много запросов

Остановите параллельные задачи, дождитесь завершения текущего запроса и повторите позже. Проверьте лимиты запросов и токенов в кабинете. Частые автоматические повторы могут снова исчерпать лимит.

400 · Неподдерживаемые параметры

Начните с короткого текстового сообщения и уменьшите лимит ответа. Один запрос может вернуть только один результат; фоновые запросы и сохранённые цепочки previous_response_id не включены. Поддержка изображений и файлов зависит от выбранной модели и подключённого провайдера. Параллельные запросы доступны в пределах общего баланса и лимитов ключа.

502 / 503 · Провайдер временно недоступен

Повторите запрос через некоторое время. Если ошибка остаётся, попробуйте другую доступную модель. Передайте поддержке время ошибки, название приложения, Model ID, HTTP-код и request_id, если он есть в ответе. Ключ передавать не нужно.

В терминале работает, а в приложении — нет

Перезапустите приложение после изменения настроек. Переменная окружения, заданная в терминале, доступна только ему и запущенным из него процессам. Убедитесь, что приложение выбрало профиль Codgeass, а не прежнего провайдера. Если запрос отклоняет браузер, попробуйте настольный клиент: веб-клиенту может требоваться серверный прокси.

Нужна помощь? Напишите продавцу в чат вашего заказа. Приложите текст ошибки без API-ключа.

05 / КОНТРОЛЬ РАСХОДА

Начните с небольшого запроса

  • Для проверки отправьте «Ответь одним словом: работает». Затем посмотрите расход в кабинете.
  • Для новой задачи создавайте новый разговор. Длинная история и файлы увеличивают объём входящих токенов.
  • Настраивайте размер контекста по возможностям модели, а лимит ответа — по задаче. Для первого теста достаточно 256–512 токенов.
  • Сравнивайте стоимость входящих и исходящих токенов. Оценка расходов внутри редактора может отличаться от фактического списания Codgeass.
Открыть личный кабинет →