CCG API Docs / OpenHands
OpenHands · интеграция

OpenHands с нашим API

OpenHands — автономный агент. Подключение через Advanced-настройки LLM: префикс модели выбирает протокол (openai/ для GPT-ключей, anthropic/ для Claude-ключей).

Начать настройку Открыть статистику

Поддерживаемые ключи

Тип ключа определяет префикс в поле Custom Model.

Ваш ключКак подключаетсяBase URLМодель (пример)
GPT (gpt-*)Custom Model openai/…https://bridge.gptclaudegemini.xyz/v1gpt-5.6-terra
Claude (claude-*)Custom Model anthropic/…https://bridge.gptclaudegemini.xyzclaude-sonnet-5
Один ключ — один тип моделей

Ключ видит только модели своего тарифа. Проверить список: GET https://bridge.gptclaudegemini.xyz/v1/models с вашим ключом.

Установка и настройка

  1. Откройте настройки LLM

    В OpenHands добавьте новый LLM Endpoint и включите «Advanced».

  2. Заполните поля

    Для GPT-ключа:

    Custom Modelopenai/gpt-5.6-terra
    Base URLhttps://bridge.gptclaudegemini.xyz/v1 (без слэша в конце)
    API Keyваш ключ sk-xxxxxxxxxx
    AgentCodeActAgent

    Для Claude-ключа:

    Custom Modelanthropic/claude-sonnet-5
    Base URLhttps://bridge.gptclaudegemini.xyz
    API Keyваш ключ sk-xxxxxxxxxx

  3. Проверьте

    Запустите простую задачу; префикс (openai/ или anthropic/) сообщает OpenHands, каким протоколом пользоваться.

Выбор модели

Доступные model ID зависят от вашего ключа:

Terminal
curl https://bridge.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

Решение проблем

Invalid API Key / 401
Проверьте, что ключ скопирован целиком и без пробелов, а Base URL указан точно как в таблице выше.
Model Not Found
Запросите список моделей вашего ключа через /v1/models и используйте точный ID из ответа.
Первый запрос упал с 5xx, повтор прошел
При недоступности одного upstream шлюз переключается на резервный, но первая попытка может вернуть ошибку. Повторите запрос.
Ошибка «LLM provider not recognized»
Проверьте префикс модели: openai/ для GPT-ключей (Base URL с /v1), anthropic/ для Claude-ключей (Base URL без суффикса).

Статистика и ключ

Статистика открывается на отдельном сервисе. Для поиска используйте полный токен; в интерфейсе отображается только маскированная часть ключа.

Открыть статистику