Skip to main content

FrootAI — AmpliFAI your AI Ecosystem Get Started

Agent FAI Platform API · v4

Embed grounded Agent FAI workflows.

One authenticated agent contract for applications, automation, Studio, and VS Code: grounded chat, architecture, citations, safe diagrams, durable threads, Play search, and cost direction.

Base URL:

API Base
https://frootai.dev/v1/agent
Runtime
FAI Engine
Transport
HTTPS + SSE
Diagrams
Mermaid
Rate limit
60 req/min
Workload integration

Embed Agent FAI in your product

Use the same grounded Agent FAI runtime from your application, automation, or Studio workload. Personal fai_live_… keys are verified through your Supabase-backed FrootAI account and never forwarded to the model service.

POST/chat

Authenticated durable workload endpoint. Continue later by sending the returned threadId — prior turns are restored server-side.

Request

{
  "message": "Design a secure RAG platform",
  "threadId": null,
  "mode": "architecture",
  "capabilities": { "diagrams": true, "citations": true }
}

Response

{
  "reply": "## Architecture\n...",
  "usage": { ... },
  "agent": {
    "requestId": "...",
    "threadId": "...",
    "version": "4.0.0",
    "mode": "architecture",
    "client": "api",
    "grounding": { "corpusSize": 1005, "sources": [...] },
    "mcp": { "status": "ok", "toolCalls": [{ "name": "search_knowledge", "status": "ok" }] }
  }
}
GET/web/health

Branded FAI Engine availability, capabilities, and authoritative catalog coverage.

Request

N/A

Response

{
  "status": "ok",
  "service": "fai-engine",
  "version": "4.0.0",
  "capabilities": ["chat", "streaming", "grounding", "citations", "mermaid", "mcp-router"],
  "catalog": { "entries": 1005, "plays": 101, "modules": 25, "mcpTools": 45 }
}
POST/web/search-plays

Search the curated core solution-play index.

Request

{ "query": "document processing" }

Response

{ "results": [{ "id": "06", "name": "Document Intelligence", "score": 0.92 }] }
POST/web/estimate-cost

Estimate monthly solution cost at development or production scale.

Request

{ "play": "01", "scale": "dev" }

Response

{ "play": { "id": "01", "name": "Enterprise RAG" }, "scale": "dev", "items": [...], "total": 245 }