Visual Agents bundles two open-source reference agents and a set of managed workflow APIs built on top of Visual Intelligence and Visual Search. Use the open-source code if you want to fork and customize; call the managed APIs if you want hosted endpoints that already work.Documentation Index
Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt
Use this file to discover all available pages before exploring further.
Video Searching Agent
Open-source + managed API. Multi-platform discovery across YouTube, TikTok, Instagram, and X — query parsing, ranked references, SSE streaming.
Video Editing Agent (VEA)
Open-source + managed primitives. End-to-end pipeline: indexing → script generation → clip planning → TTS → render. Or call
/video/edit, /video/clip, /video/split directly.Screenplay Extraction
Managed API only. Submit a short drama episode → get back structured storyboard data (scene breakdowns, transcripts, character namelist). Async with webhook callback.
Agent Examples
Eight runnable ReAct agents — SOP compliance, service quality, security, public-platform search, video editing, personal memory, visual RAG, creator intelligence. Live-verified against
api.memories.ai.What’s Inside
| Agent / Service | Open-source repo | Managed API | Type |
|---|---|---|---|
| Video Searching Agent | Memories-ai-labs/video-searching-agent | POST /queries/stream (API ref) | Agent — searches social platforms |
| Video Editing Agent | Memories-ai-labs/vea-open-source | POST /video/edit, POST /video/clip, POST /video/split | Agent + primitive editing endpoints |
| Screenplay Extraction | — (managed service) | POST /screenplay/tasks (async) + status / cancel / download | Workflow API — analyses short drama episodes |
Looking for the Memories CLI? It’s a separate ecosystem-wide tool — see the Documentation overview.
Which One Do I Use?
| Goal | Pick |
|---|---|
| Discover trending content / creators across social platforms | Video Searching Agent (or call /queries/stream directly) |
| Turn a long video into a short-form highlight reel | Video Editing Agent (fork it for full pipeline) |
| Just clip / split / re-edit individual segments | Call the primitive endpoints under VEA (/video/clip, /video/split, /video/edit) |
| Extract structured storyboard / screenplay from drama episodes | Screenplay Extraction |
| Drive the platform from terminal / scripts | Memories CLI |
Two Ways to Adopt
| Path | When to use | What you do |
|---|---|---|
| Fork the open-source agent | You want full control over prompts, tools, models, scoring logic | git clone the repo, configure keys, customize, run on your own infra |
| Call the managed API | You just want results, no infra | POST to the managed endpoint with your API key; we run the agent |
Shared Foundation
- Underlying APIs: All agents/services call Visual Intelligence (for inference) and optionally Visual Search (for indexed search).
- Auth: Same
Authorization: sk-mavi-...API key as the rest of the platform — no separate key. - Billing: Calls hit the underlying Visual Intelligence / Visual Search endpoints and bill against those line items. No additional “agent fee”.
- Webhooks: Async services (Screenplay Extraction, VEA) require a configured webhook — see Webhooks.
Getting Started
- Pick the agent or service that matches your goal (table above).
- Get an API key from the Memories.ai Console. The same key works across Visual Intelligence, Visual Search, and Visual Agents.
- Configure webhooks if you’ll use any async endpoint (VEA, Screenplay Extraction).
- Open the per-agent page for setup instructions specific to that agent.