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