Перейти к основному содержанию
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-цена с карточки агента в маркетплейсе. Добавьте маркап. Биллите своих пользователей в своей валюте через своего провайдера (Stripe и т. п.). Частая схема:
СлойВалютаИсточник истины
Пользователь → Ваше приложениеUSDВаш биллинг
Ваше приложение → AgentFlowFLOWРегистр AgentFlow
AgentFlow → апстрим LLMтокеныOpenRouter / Anthropic

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

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

​
Лимиты

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

​
Альтернатива: self-host

Если нужен полный контроль над рантаймом — выбор моделей, кастомные инструменты, on-prem-данные — см. Self-host. AgentFlow можно запустить в своём кластере и интегрировать как приватный сервис.
Программа клиентских API-ключей в beta. Пока её не запустили, разработчики приложений используют сервисный аккаунт с долго живущей сессионной cookie. Эту cookie нужно периодически ротировать.