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

Droid с нашим API

Droid — CLI-агент от Factory. Наши модели добавляются как custom models в один файл конфигурации: GPT-ключи через OpenAI-совместимый провайдер, Claude-ключи через провайдер anthropic.

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

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

Тип ключа определяет значение поля provider в custom_models.

Ваш ключКак подключаетсяBase URLМодель (пример)
GPT (gpt-*)generic-chat-completion-apihttps://bridge.gptclaudegemini.xyz/v1/gpt-5.6-terra
Claude (claude-*)anthropichttps://bridge.gptclaudegemini.xyzclaude-sonnet-5
Один ключ — один тип моделей

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

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

  1. Установите Droid

    Terminal
    curl -fsSL https://app.factory.ai/cli | sh

  2. Добавьте custom model

    Файл ~/.factory/config.json. Если массив custom_models уже есть — добавьте объект в него, не удаляя существующие. Для GPT-ключа:

    ~/.factory/config.json
    {
  "custom_models": [
    {
      "model_display_name": "GPT 5.6 Terra (CCG)",
      "model": "gpt-5.6-terra",
      "base_url": "https://bridge.gptclaudegemini.xyz/v1/",
      "api_key": "sk-xxxxxxxxxx",
      "provider": "generic-chat-completion-api"
    }
  ]
}

    Для Claude-ключа используйте провайдер anthropic:

    ~/.factory/config.json
    {
  "custom_models": [
    {
      "model_display_name": "Claude Sonnet 5 (CCG)",
      "model": "claude-sonnet-5",
      "base_url": "https://bridge.gptclaudegemini.xyz",
      "api_key": "sk-xxxxxxxxxx",
      "provider": "anthropic"
    }
  ]
}
    Слэш в конце base_url

    Для generic-chat-completion-api оставьте завершающий / после /v1. Для провайдера anthropic суффикс не нужен.

  3. Запустите

    Откройте новый терминал, выполните droid и выберите модель по имени из model_display_name.

Выбор модели

Доступные 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 шлюз переключается на резервный, но первая попытка может вернуть ошибку. Повторите запрос.
Droid не показывает модель
Проверьте JSON-валидность ~/.factory/config.json и откройте новый терминал: Droid читает конфиг при запуске.

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

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

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