Youyun API Youyun API Документы

yycode × Hermes: руководство быстрого старта

Сценарий использования

Эта статья решает только одну задачу: подключить Anthropic-совместимый интерфейс yycode к Hermes и выполнить минимальную проверку работоспособности.

Если сейчас вы используете Hermes, а не OpenClaw, Cherry Studio или другой клиент, эта статья описывает соответствующий способ подключения.

1. Подготовка

Перед началом проверьте:

  • Вы уже создали API Key в консоли yycode
  • Вы знаете фактическое имя модели, которую Hermes должен вызывать
  • Вы можете редактировать конфигурационный файл Hermes config.yaml
  • В этот раз вы подключаете Anthropic-совместимую конечную точку yycode, а не OpenAI-совместимую

2. Поддерживаемые модели

В этой статье в первую очередь описано подключение Anthropic-совместимых моделей yycode. Частые имена моделей:

Имя модели
claude-opus-4-6
claude-sonnet-4-6
claude-haiku-4-5-20251001

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

3. Рекомендуемый путь: подключение через custom_providers Hermes

При подключении Hermes к yycode основная идея такая:

  1. Объявить provider yycode в custom_providers
  2. В блоке model направить модель по умолчанию на этот provider
  3. Отключить smart_model_routing, чтобы Hermes автоматически не переключался на другую модель

Шаг 1: определите пользовательский provider

custom_providers:
  - name: custom-yycode-net-aws
    base_url: https://yycode.net
    api_key: <your-key>
    api_mode: anthropic_messages
    models:
      - claude-opus-4-6

Здесь важнее всего два пункта:

  • base_url укажите как https://yycode.net
  • api_mode обязательно должен быть anthropic_messages

Шаг 2: направьте модель по умолчанию на этот provider

model:
  default: claude-opus-4-6
  provider: custom-yycode-net-aws
  base_url: https://yycode.net
  api_key: <your-key>
  api_mode: anthropic_messages

provider здесь должен соответствовать name из custom_providers выше, иначе Hermes не пойдет через определенный вами Dragon Code provider.

Шаг 3: отключите Smart Model Routing

smart_model_routing:
  enabled: false

Если не отключить, Hermes может из-за короткого сообщения автоматически перейти на более дешевую модель, и вы увидите, что настроили claude-opus-4-6, но фактически запускается другая модель.

4. Минимальная рабочая конфигурация для прямого использования

Ниже приведен объединенный минимальный пример. Замените <your-key> на свой Dragon Code API Key:

model:
  default: claude-opus-4-6
  provider: custom-yycode-net-aws
  base_url: https://yycode.net
  api_key: <your-key>
  api_mode: anthropic_messages

custom_providers:
  - name: custom-yycode-net-aws
    base_url: https://yycode.net
    api_key: <your-key>
    api_mode: anthropic_messages
    models:
      - claude-opus-4-6

smart_model_routing:
  enabled: false

fallback_providers:
  - provider: minimax-cn
    model: MiniMax-M2.7

Если хотите переключиться на другую Anthropic-совместимую модель, достаточно одновременно изменить имя модели в model.default и custom_providers[].models.

5. Критерии успеха

Если выполнены пункты ниже, значит Hermes и Dragon Code в целом уже соединены:

  • base_url указан как https://yycode.net
  • api_mode указан как anthropic_messages
  • model.provider указывает на имя provider, определенное в custom_providers
  • smart_model_routing.enabled отключен
  • После отправки сообщения Hermes реально получает ответ модели

6. Частые вопросы

Почему нельзя подключать как OpenAI-совместимый интерфейс?

В этом подключении Hermes к yycode следует использовать нативный формат сообщений Anthropic, то есть /v1/messages.

Известные выводы:

  • /v1/messages работает
  • /v1/chat/completions не подходит как основной путь для этой конфигурации Hermes

Поэтому api_mode обязательно должен быть anthropic_messages; не настраивайте по OpenAI-совместимому режиму.

Почему я выбрал claude-opus-4-6, но фактически запускается другая модель?

Сначала проверьте, отключен ли smart_model_routing.enabled.

Если в Hermes включена умная маршрутизация, короткие сообщения могут автоматически переводиться на дешевую модель, из-за чего выбор в интерфейсе и реальная модель запроса не совпадают.

Можно ли использовать api_key_env?

По текущей записи конфигурации, в Hermes v0.10.0 api_key_env в блоках model и custom_providers работает нестабильно: переменная окружения может не раскрыться корректно, и в итоге вернется 401.

Если вы уже подтвердили, что проблема именно в этом, сначала вернитесь к прямому указанию api_key, запустите цепочку, а затем решайте, продолжать ли разбор варианта с переменной окружения.

Почему возвращается 401?

Обычно сначала проверяют:

  • Действителен ли API Key
  • Заполнен ли api_key в нужных местах model и custom_providers
  • Действительно ли Hermes загрузил измененный конфигурационный файл

Почему возвращается 503 или service unavailable?

Если текущая конфигурация идет по OpenAI-совместимому пути, сначала вернитесь и проверьте, не задан ли в Hermes неправильный api_mode.

Рекомендуемый путь в этой статье — Anthropic-совместимое подключение; не рекомендуется смешивать его с OpenAI-совместимым вариантом.

7. Пример проверки API

Если хотите сначала обойти Hermes и напрямую проверить доступность конечной точки Dragon Code, можно вызвать нативную конечную точку Anthropic:

curl -X POST "https://yycode.net/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: <your-key>" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-opus-4-6","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}'

Если этот запрос нормально возвращает ответ, затем проверять конфигурацию Hermes будет проще.

8. Следующий шаг

  • Хотите подключить другие клиенты: смотрите OpenClaw Быстрый старт, Cherry Studio Быстрый старт
  • Еще не создали Key: вернитесь в консоль yycode и сначала создайте API Key
  • Хотите унифицировать конфигурацию инструментов разработки: продолжайте читать другие документы быстрого подключения на сайте
Вся страница скопирована