Ключи AI-провайдеров
Настройте учётные данные «принеси свой ключ» для текстовых и голосовых провайдеров.
Настройте учётные данные «принеси свой ключ» для текстовых и голосовых провайдеров.
«Принеси свой ключ» (BYOK) позволяет поддерживаемым запросам ИИ использовать ваш аккаунт у AI-провайдера. Ключ не обязателен: по умолчанию модели предоставляет платформа. Сохранение ключа требует Scale. Уже хранимые ключи продолжают работать на Launch и Operate. Вы по-прежнему платите тариф Make Agent Fast плюс фиксированную комиссию платформы за действие; провайдер выставляет использование модели напрямую вам.
Поддерживаемые провайдеры#
Новые ключи можно добавить только для двух провайдеров — одного для текста и одного для голоса:
| Провайдер | Используется для | Создать или проверить ключ |
|---|---|---|
| OpenRouter | Генерация текста агента во всех моделях, к которым маршрутизирует OpenRouter | Ключи OpenRouter API |
| Speko | Речь-в-текст и синтез речи | Платформа Speko |
Устаревшие ключи#
Прямые ключи вендоров, сохранённые до перехода на OpenRouter и Speko, отображаются в разделе Устаревшие ключи. Они продолжают работать, пока вы их не отзовёте, и отозвать их по-прежнему можно, но добавить или заменить такой ключ нельзя:
| Устаревший провайдер | Используется для | Справка провайдера |
|---|---|---|
| Anthropic, OpenAI, Google Gemini, xAI, DeepSeek | Генерация текста агента | Документация Anthropic API, Быстрый старт OpenAI API, Ключи Gemini API |
| Deepgram | Речь-в-текст, когда Deepgram — настроенный провайдер STT | Ключи Deepgram API |
| ElevenLabs | Синтез речи, когда настроен ElevenLabs | Аутентификация ElevenLabs |
Доступность провайдера также зависит от настроенных провайдеров текста, речи и реального времени платформы. Сохранение валидного ключа не заставляет каждую функцию использовать этого провайдера.
Добавьте ключ провайдера#
- Создайте ключ в консоли OpenRouter или Speko и включите оплату провайдера или лимит расходов, если требуется.
- Откройте Панель → Настройки → Ключи провайдеров ИИ. Сохранить ключ может только владелец оплаты рабочего пространства Scale.
- Вставьте ключ в карточку OpenRouter или Speko.
- Выберите Проверить и сохранить.
- Дождитесь результата проверки, затем протестируйте функцию, использующую провайдера.
Make Agent Fast выполняет живой запрос проверки перед сохранением ключа; токены модели и кредиты платформы при этом не расходуются. Ключ не должен содержать пробелов или переносов строк и должен быть от 16 до 512 символов. Ключи OpenRouter должны начинаться с sk-or-; ключи Speko — с sk_speko_ или sk_live_. Живая проверка авторитетна.
Сохранение другого рабочего ключа для того же провайдера заменяет предыдущее хранимое значение. Ключ, не прошедший проверку, не сохраняется, поэтому уже хранимый ключ продолжает работать. Панель сохраняет только безопасные идентификационные данные вроде последних четырёх символов, времени проверки и состояния.
Как работает выбор текстового провайдера#
Для генерации текста приоритет у активного ключа OpenRouter. Если его нет, Make Agent Fast ищет активный устаревший ключ, совпадающий с настроенным текстовым провайдером платформы, затем остальные устаревшие текстовые ключи (Anthropic, OpenAI, Gemini, xAI, DeepSeek) в этом порядке. Если подходящего ключа BYOK нет, использует провайдера платформы, когда тариф и развёртывание позволяют.
Ключи речи специфичны для провайдера. Ключ Speko используется, когда речь обрабатывается через Speko. Устаревший ключ Deepgram используется только когда активный провайдер речи-в-текст — Deepgram; устаревший ключ ElevenLabs используется только когда синтез речи настроен для ElevenLabs.
Ключи BYOK сейчас не заменяют учётные данные эмбеддинга знаний платформы. Приём и поиск знаний продолжают использовать настроенного провайдера эмбеддингов развёртывания.
Оплата и кредиты#
- Внешний провайдер списывает использование токенов ИИ с аккаунта, выдавшего ключ.
- Make Agent Fast по-прежнему списывает подписку плюс фиксированную комиссию платформы за каждое действие, выполняемое на вашем ключе: 1 кредит за ответ в чате вместо списания по токенам. Комиссия оплачивает поиск, оркестрацию и хостинг вокруг вызова и не является процентом от вашего счёта за токены.
- Комиссия применяется к каждому вызову провайдера. Шаги речи, которые финансирует платформа (например, транскрибация, когда у вас есть только текстовый ключ), списываются по обычной ставке, а живые звонки всегда используют ставку платформы.
- Исчерпание квоты провайдера может отклонить запрос даже при оставшихся кредитах Make Agent Fast.
Проверяйте и Использование и кредиты в Make Agent Fast, и собственную панель использования провайдера.
Состояния ключей и обработка сбоев#
| Состояние | Значение | Что делать |
|---|---|---|
active | Живая проверка успешна | Протестируйте целевую функцию и следите за использованием провайдера |
invalid | Провайдер позже отклонил хранимый ключ | Проверьте оплату, ограничения, квоту и состояние отзыва провайдера; затем сохраните замену (OpenRouter или Speko) |
revoked | Ключ отключён в Make Agent Fast | Сохраните новый ключ OpenRouter или Speko, если функция должна продолжать использовать BYOK |
Если запрос не работает, потому что провайдер отклоняет учётные данные или квоту, Make Agent Fast может пометить хранимый ключ недействительным. Исправление ключа у провайдера не раскрывает и не переписывает хранимый секрет; для ключа OpenRouter или Speko используйте Проверить подключение, чтобы перепроверить его, или сохраните рабочий ключ снова. Устаревший ключ, ставший недействительным, нельзя заменить другим устаревшим ключом — вместо этого переведите этого провайдера на OpenRouter или Speko.
Ротируйте ключ провайдера#
- Создайте новый ключ провайдера, не удаляя старый.
- Сохраните новый ключ в Make Agent Fast и подтвердите, что он стал активным.
- Протестируйте текстовый чат или голосовые сообщения — то, что использует этого провайдера.
- Отзовите старый ключ в консоли провайдера.
- Проверьте логи провайдера на неожиданное использование старого ключа.
Если ключ раскрыт в системе контроля версий или браузерном коде, немедленно отзовите его у провайдера. Его удаление только из Make Agent Fast не останавливает другого держателя от прямого использования с провайдером.