What Trio Does
Trio turns live video streams into API results you can automate against. You send a stream URL and a natural-language condition, then choose the delivery pattern that fits your app:- Immediate JSON response for one-off checks
- Async job + polling for backend workflows
- SSE for live client updates
- Webhooks for event-driven automation
What This Documentation Covers
This documentation is focused on API consumption only:- How to authenticate and call endpoints
- How to choose delivery patterns
- How to interpret responses and job states
- How to implement reliable production workflows
Product Surface in 60 Seconds
| Goal | Endpoint |
|---|---|
| Confirm a stream is live | POST /streams/validate |
| Ask a yes/no question right now | POST /check-once |
| Watch for a condition over time | POST /live-monitor |
| Get periodic narrative summaries | POST /live-digest |
| Track async runs | GET /jobs, GET /jobs/{job_id}, DELETE /jobs/{job_id} |
Vibe Coding with Agents
If you use a coding agent, you can hand it a ready-made prompt or doc and start building immediately. Pick the path that matches your workflow:- Agent Project Setup: Full bootstrap prompt for building a Trio integration from the OpenAPI schema. Agent Project Setup
- MCP Integration: One-line MCP setup for direct tool wiring in Claude CLI. MCP Integration
- Trio Agent Skill: A drop-in system prompt for agents that need best practices and workflows baked in. Trio Agent Skill
Recommended Learning Path
- Set up API auth: Authentication
- Run your first workflow: First Successful Workflow
- Pick the right endpoint and delivery mode: Choose Your Workflow
- Learn behavior and tradeoffs: Monitoring Modes and Delivery Patterns
- Implement production patterns: Guides
Next Steps
- Start now: Authentication
- Build your first run: First Successful Workflow
- Explore endpoint details: API Reference