Перейти к основному содержанию
Агенты AgentFlow под капотом обращаются к сторонним провайдерам ИИ — Anthropic для Claude, OpenAI для GPT-4o и DALL-E, ElevenLabs для голоса, Stability для картинок, Perplexity для поиска, и так далее. По умолчанию они используют платформенные кредиты, оплачиваемые в $FLOW. Bring Your Own Key (BYOK) — режим, в котором ты добавляешь свои ключи в кабинет и агенты используют именно их. Ты платишь провайдеру напрямую по его оптовому тарифу; AgentFlow считает только время оркестрации, а не токены.

​
Зачем это нужно

  • Не платить наценку FLOW, если у тебя уже есть платный аккаунт Anthropic / OpenAI.
  • Использовать провайдеров, которых у нас нет (Runway, Pika, Cartesia, Brave Search, …).
  • Попробовать новую модель в день релиза — не дожидаясь, пока мы её добавим в каталог.

​
Как защищены ключи

  • Плейнтекст шифруется AES-256-GCM до записи в базу. Мастер-ключ — AGENTS_MASTER_KEY, ротируется отдельно от JWT secret.
  • Кабинет видит только маскированный префикс (первые 8 символов + ***).
  • Отзыв — soft delete: строка остаётся в аудите, но рантайм перестаёт её выдавать.

​
Добавить ключ (3 шага мастера)

1

Выбери категорию

/account/keys показывает пять карточек — по одной на возможность ИИ:
КатегорияПримеры
LLMAnthropic, OpenAI, OpenRouter, Groq
ImageDALL·E, Stability, Fal, Replicate
VideoRunway, Luma, Pika, Fal Video
AudioElevenLabs, OpenAI TTS, Cartesia
ResearchPerplexity, Tavily, Serper, Brave, Exa
Отдельной категории «OAuth» больше нет — OAuth, если он поддерживается, это просто альтернативный способ авторизации у конкретного провайдера (см. Anthropic ниже).
2

Выбери провайдера

Внутри каждой карточки — список провайдеров. Бери того, в чьей панели у тебя уже есть ключ.Большинство провайдеров принимают только вставленный API key. У Anthropic в каталоге заявлен путь OAuth для пользователей Claude Pro / Max, но публичного OAuth-эндпоинта Anthropic пока не публикует — клик по Continue with Claude OAuth возвращает oauth_not_available («OAuth Max — coming soon»). Используй API key из Anthropic Console.
3

Вставь ключ, назови, сохрани

Поле label (опционально) помогает пометить ключ (например prod, personal, client-x). Кабинет показывает label везде — пригодится, если у тебя несколько ключей одного провайдера.Мастер делает запрос на testUrl провайдера с заголовком Authorization: Bearer <key> (или x-api-key для Anthropic) и показывает зелёную плашку, если получил 2xx. У некоторых провайдеров (Pika, Cartesia) дешёвого test-эндпоинта нет — этот шаг тогда пропускается.

​
Ротация

Можно держать несколько ключей одного провайдера. Рантайм при каждом вызове берёт тот, у которого rotation_priority минимальный. Двигай порядок стрелочками в строке:
  • 0 = максимальный приоритет (по умолчанию у новых ключей)
  • больше = fallback
Если приоритетный ключ сломался, рантайм сейчас откатывается к платформенному умолчанию. Полноценный fallback по нескольким ключам появится в следующей итерации; пока самая чистая схема — один ключ на провайдера с приоритетом 0.

​
Скоро — аренда ключей

Колонка Rentable — задел под будущий маркетплейс. Идея: ты ставишь свою неиспользуемую квоту Anthropic в стейк, платформа маршрутизирует чужие вызовы через твой ключ, ты получаешь FLOW, AgentFlow забирает комиссию. Чек-бокс пока выключен; схема в БД уже есть — выкатим без миграции.

​
Примеры API

# Список активных ключей
curl -s "$BASE/me/provider-keys" \
  -H "Authorization: Bearer $JWT"

# Добавить ключ Anthropic
curl -s "$BASE/me/provider-keys" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $JWT" \
  -d '{"category":"llm","provider":"anthropic","auth_type":"api_key","label":"main","value":"sk-ant-…"}'

# Проверить ключ
curl -s -X POST "$BASE/me/provider-keys/42/test" \
  -H "Authorization: Bearer $JWT"

# Отозвать
curl -s -X DELETE "$BASE/me/provider-keys/42" \
  -H "Authorization: Bearer $JWT"

​
Что делать, если

  • Test вернул 401 — ключ неверный или просрочен. Перепаст из панели провайдера.
  • /oauth/anthropic/start отвечает 501 oauth_not_available — это ожидаемо. Публичного OAuth у Anthropic сейчас нет; Pro/Max OAuth работает только для своих первичных клиентов (например Claude Code). Используй API key с platform.claude.com.
  • Агент всё равно использует платформенный Anthropic — категория ключа должна совпадать с тем, что нужно агенту. Агент с @elizaos/plugin-openai не подхватит ключ Anthropic. Либо добавь ключ OpenAI, либо смени плагин в настройках агента.