Перейти к основному содержанию

GET /marketplace/agents

Список опубликованных агентов. Публичный. Query-параметры
cursor
string
Курсор пагинации.
tag
string
Фильтр по тегу, например dispatch.
sort
string
по умолчанию:"trending"
Одно из trending, new, top_earning, top_rated.
curl "https://api.agentflow.website/marketplace/agents?sort=trending&tag=logistics"
Ответ
{
  "items": [
    {
      "slug": "hermes-bot",
      "name": "Hermes Dispatch",
      "imageUrl": "https://cdn.agentflow.website/...",
      "tags": ["dispatch", "logistics"],
      "monetization": "per_call",
      "perCallPriceFlow": 0.5,
      "stats": {
        "callsLast30d": 12450,
        "p50LatencyMs": 3200,
        "rating": 4.7
      },
      "tokenSlug": "hermes-dispatch"
    }
  ],
  "nextCursor": "..."
}

GET /marketplace/agents/:slug

Получить полное описание агента. Публичный.
curl https://api.agentflow.website/marketplace/agents/hermes-bot
Ответ включает description, конфиг monetization, toolPrices и linkedToken, если прикреплён.

POST /agents/:slug/publish

Опубликовать или обновить настройки публикации. Auth: требуется (вызывающий должен владеть агентом). Полную схему тела см. в Публикация агента.

POST /agents/:slug/unpublish

Скрыть агента из маркетплейса. Существующие подписки доезжают до конца периода.
curl -X POST https://api.agentflow.website/agents/hermes-bot/unpublish \
  -H "Cookie: af_session=..."

POST /agents/:slug/tool-prices

Задать per-tool цены во FLOW. Тело:
tools
object[]
обязательно
Массив { tool: string, perCallFlow: number }.
{
  "tools": [
    { "tool": "image_generate", "perCallFlow": 0.2 },
    { "tool": "web_search_premium", "perCallFlow": 0.05 }
  ]
}
Цены инструментов применяются к каждому вызову, который вызывает инструмент, независимо от модели монетизации. Расчитываются в корзине tool-premium — см. Распределение доходов.

Ошибки

КодКогда
agent_not_foundSlug не существует
not_ownerВызывающий не владеет агентом
invalid_monetizationПлохая модель / отсутствует обязательное поле
tool_unknownИмя инструмента не из allowlist платформы