Trugen AI
Build real-time conversational video agents — AI-powered avatars that see, hear, speak, and reason with users in under 1 second of latency.
| |
|---|
| API Base URL | https://api.trugen.ai |
| Authentication | x-api-key: <your-api-key> header on all requests |
| Official Docs | docs.trugen.ai |
| Developer Portal | app.trugen.ai |
Required Credentials
| Variable | Description | Where to Get |
|---|
TRUGEN_API_KEY | Primary API key for all Trugen API calls (sent as x-api-key header) | Developer Portal |
TRUGEN_AVATAR_ID | (Optional) Default avatar ID for LiveKit integration | Developer Portal |
Security: Never expose TRUGEN_API_KEY in client-side code. For widget/iFrame embeds, use a server-side proxy to keep keys secret. See references/embedding.md for details.
Platform Pipeline
| Step | Component | Function |
|---|
| 1 | WebRTC | Bidirectional audio/video streaming |
| 2 | STT (Deepgram) | Streaming speech-to-text |
| 3 | Turn Detection | Natural conversation boundary detection |
| 4 | LLM (OpenAI, Groq, custom) | Contextual response generation |
| 5 | Knowledge Base | Grounding answers in your data |
| 6 | TTS (ElevenLabs) | Natural, expressive speech synthesis |
| 7 | Huma-01 | Neural avatar video generation with lip sync & microexpressions |
Quickstart
- Create an agent →
POST /v1/ext/agent — see references/agents.md
- Embed via iFrame or Widget — see references/embedding.md
API Endpoints Overview
| Resource | Endpoints | Reference |
|---|
| Agents | Create, Get, List, Update, Delete, Create from Template | agents.md |
| Knowledge Base | Create KB, Add Docs, Get, List, Update, Delete KB/Doc | knowledge-base.md |
| Templates | Create, Get, List, Update, Delete persona templates | templates.md |
| Tools & MCPs | Create/manage function-calling tools and MCP servers | tools-and-mcps.md |
| Webhooks | Callback events, payload format, handler examples | webhooks.md |
| Embedding | iFrame, Widget, LiveKit integration + avatar IDs | embedding.md |
| Providers/Avatars | Available LLMs, STT, TTS, avatars, languages, BYO-LLM | providers-avatars-languages.md |
| Prompting | Voice prompt strategies, guardrails, use case examples | prompting-and-use-cases.md |
Conversations
Retrieve transcripts for completed sessions:
GET /v1/ext/conversation/{id} — Returns agent_id, status, transcript array, recording_url.
Workflow Guide
Determine what the user needs, then load the appropriate reference:
Developer Resources