Подключение внешних инструментов к Cloud API OpenDesign

Управляйте API-ключами OpenDesign в веб-интерфейсе и используйте модели, доступные по вашему тарифу, во внешнем агенте. Настольное приложение OpenDesign не требуется. Настройка в один клик импортирует подключение через CC Switch на вашем компьютере.

Выберите нужное подключение

Чтобы добавить ключ провайдера в OpenDesign, следуйте инструкции по настройке BYOK. В этом руководстве рассматривается обратный сценарий: использование API моделей OpenDesign Cloud во внешнем инструменте, например Claude Code или Codex.

Перед началом

Облачный API OpenDesign доступен в тарифах Go, Plus, Pro и Max. Тариф Free не поддерживается. Список Model в вашей учётной записи определяет, какие текстовые модели вы можете использовать; модели на снимках экрана приведены в качестве примеров и не означают, что они доступны во всех тарифах.

Поддерживаются агенты Claude Code, Codex, Grok Build, OpenCode, OpenClaw и Hermes Agent. Сначала установите выбранный агент. Если CC Switch уже установлен, этап его установки можно пропустить.

Откройте раздел API-ключей в веб-интерфейсе

Войдите в веб-интерфейс управления учетной записью OpenDesign и выберите на боковой панели API keys (API-ключи). В правом верхнем углу выберите One-click agent setup (настройка агента в один клик). Начать можно и без существующего ключа.

Полная страница API keys: кнопка One-click agent setup находится в правом верхнем углу, а раздел Connection setup содержит форматы API и соответствующие базовые URL-адреса.

Для ручной настройки откройте Connection setup, выберите формат API, необходимый вашему инструменту: Chat Completions, Responses или Messages — и скопируйте соответствующий API base URL. Конечная точка и протокол должны соответствовать друг другу. Ниже описан импорт одним нажатием.

Шаг 1. Установите и откройте CC Switch

В разделе One-click agent setup выберите Download for Mac (скачать для Mac) или Download for Windows (скачать для Windows).
Установите и откройте CC Switch. Пропустите этот шаг, если приложение уже установлено.

Шаг 2. Выберите агент и модель

Выберите целевой агент. По умолчанию выбран Claude Code.
Выберите в списке Model текстовую модель, доступную на вашем тарифе. Если ни одна модель недоступна, выберите другого агента или проверьте свой тариф. Копирование названия модели со снимка экрана не предоставляет к ней доступ.

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

Шаг 3. Импортируйте подключение и перезапустите агент

Выберите Import into CC Switch (импортировать в CC Switch). Будет создан новый ключ, названный по агенту и системе, например Claude Code · Mac, после чего откроется CC Switch.
Разрешите действие Open CC Switch в запросе браузера. Проверьте API Endpoint, ключ и модель в CC Switch, затем выберите Import.
Вернитесь на веб-страницу и выберите Done (готово) или Set up another agent (настроить другой агент), чтобы создать еще одно подключение.
Перезапустите целевой агент. Для Claude Code завершите текущий сеанс и выполните claude в новом терминале.

Окно подтверждения CC Switch: перед импортом проверьте конечную точку и модель. Ключ на этом снимке экрана скрыт.

При каждой настройке в один клик создается новый ключ; использовать существующий ключ повторно нельзя. Существующие ключи не изменяются. Предыдущая конфигурация агента остается доступной в CC Switch.

Проверьте активное подключение

Отправьте короткое сообщение в перезапущенном агенте и убедитесь, что он отвечает.
В Claude Code выполните /status и сравните указанную модель с выбранной вами. В других агентах используйте аналогичный экран состояния.
На веб-странице API keys проверьте, обновилось ли время Last used (последнее использование) для нового ключа.

Если по-прежнему активна старая модель, закройте старый сеанс и перезапустите агент. Если браузер не открыл CC Switch, найдите рядом с адресной строкой запрос подтверждения, откройте CC Switch и снова выберите Open. В дальнейшем модель можно менять в CC Switch без повторной настройки.

Вернитесь к прежней конфигурации или отзовите доступ

В CC Switch найдите предыдущую конфигурацию агента и включите ее, чтобы вернуться к прежнему подключению. Удаление конфигурации CC Switch не отключает API-ключ. Чтобы ключ перестал работать, отзовите его на веб-странице API keys.

Проверьте текущий тариф и доступность моделей на странице учетной записи. Полную запись процесса и снимки экрана см. в руководстве по настройке агента в один клик, а сведения о настройке учетной записи — в разделе Подписки и оплата.

Используют ли вызовы API общие кредиты с приложением?

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

Откройте Cloud console, чтобы управлять ключами и использованием. Инструменты наподобие Zcode, которые принимают пользовательскую конечную точку модели и ключ, можно настроить для соответствующего протокола API. Это не означает, что OpenDesign может запускать такой инструмент как встроенный локальный агент.

Запросы с изображениями превышают ограничение размера

Согласно текущим рекомендациям службы поддержки, размер тела API-запроса ограничен 50 MiB. Ограничение применяется ко всему телу запроса, а не к каждому изображению; кодирование изображения также увеличивает его размер. Уменьшите количество изображений или их размеры и повторите попытку с небольшим запросом. Если ошибка сохраняется, сообщите службе поддержки статус ответа, время запроса и модель, не раскрывая свой ключ.