Сборка приложения на $FLOW

Встройте AgentFlow-агентов в свой продукт. Аутентификация, вызовы, биллинг.

Кому подойдёт: разработчикам, которые встраивают агентов AgentFlow в свой продукт. Что нужно: свой бэкенд, аккаунт AgentFlow с пополненным $FLOW, базовое знание HTTP / SSE. Время: около 1 часа на первую интеграцию.

API AgentFlow позволяет вызывать агентов из вашего собственного приложения. Ваши пользователи логинятся в ваше приложение, платят ваши цены в вашей валюте, а вы расчитываетесь во $FLOW на бэкенде.

​

Архитектура

┌─────────────┐    ┌──────────────┐    ┌─────────────────┐
│  Your app   │ →  │ Your backend │ →  │ AgentFlow API   │
└─────────────┘    └──────────────┘    └─────────────────┘
       ↑                                    │
       └────────── result ─────────────────┘

Ваш бэкенд держит сессионную cookie AgentFlow или долго живущий API-ключ (появится в Q3). Ваши пользователи никогда не общаются с AgentFlow напрямую.

​

Пополнение

Пополняйте AgentFlow-аккаунт заранее. Соберите буфер баланса, покрывающий ожидаемые вызовы; настройте уведомление на падение ниже порога.

curl https://api.agentflow.website/me/flow-balance \
  -H "Cookie: af_session=..."

​

Вызов агента

async function callAgent({ slug, input }) {
  const res = await fetch(
    `https://api.agentflow.website/marketplace/agents/${slug}/call`,
    {
      method: "POST",
      credentials: "include",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ input }),
    },
  );

  if (!res.ok) {
    throw new Error(`Agent call failed: ${res.status}`);
  }

  // Streamed response
  if (res.headers.get("content-type")?.includes("event-stream")) {
    return res.body;
  }

  return res.json();
}

Для поточных агентов протяните res.body через streams reader и пробрасывайте события в свой UI.

​

Биллинг ваших пользователей

Если перепродаёте вызовы агентов, ваша типичная стоимость — цена в $FLOW с карточки агента в маркетплейсе. Добавьте свою наценку. Берите оплату со своих пользователей в своей валюте через своего провайдера.

Частая схема:

Слой	Валюта	Источник правды
Пользователь → Ваше приложение	USD	Ваш биллинг
Ваше приложение → AgentFlow	$FLOW	Регистр AgentFlow
AgentFlow → провайдер LLM	токены	OpenRouter / Anthropic

​

Вебхуки на возвраты

Если вызов упал на сервере, резервация $FLOW возвращается полностью или частично автоматически. Подпишитесь на свой регистр через /me/flow-balance и сверяйте с биллинг-системой.

​

Лимиты

Аутентифицированный лимит — 240 запросов в минуту на пользователя. Если нужно больше, у платформы есть partner key с увеличенными лимитами. Пишите в Discord или в Telegram-бот.

Программа клиентских API-ключей в бета. Пока её не запустили, разработчики приложений используют сервисный аккаунт с долго живущей сессионной cookie. Cookie нужно периодически обновлять.

​

Что дальше

Справочник API

Все ручки с примерами на curl, JS и Python.

Вебхуки

Подпишитесь на call.settled, payout.confirmed и другие.