VLTRONAgents API
Programmatic access to VLTRON agents
The Agents API lets you interact with VLTRON agents programmatically, enabling automation and integration with your applications.
Getting Started
Base URL
https://vltron.com/api/v1Authentication
Use your VLTRON API key in the Authorization header:
Authorization: Bearer YOUR_VLTRON_API_KEYCreate an Agent
curl -X POST https://vltron.com/api/v1/agents \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Agent",
"description": "A custom agent for my tasks",
"tools": ["web_search", "code_interpreter"]
}'Chat with an Agent
curl -X POST https://vltron.com/api/v1/agents/{agent_id}/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"message": "Hello, help me with this task"
}'List Available Agents
curl https://vltron.com/api/v1/agents \
-H "Authorization: Bearer YOUR_API_KEY"Available Tools
| Tool | Description |
|---|---|
web_search | Search the internet |
code_interpreter | Execute code |
image_generation | Generate images |
artifacts | Create interactive content |
file_search | Search uploaded files |
Rate Limits
- Free tier: 100 requests per day
- Starter: 1,000 requests per day
- Pro: 10,000 requests per day
Error Handling
| Status Code | Description |
|---|---|
| 400 | Bad request - check your parameters |
| 401 | Unauthorized - check your API key |
| 429 | Rate limit exceeded - wait and retry |
| 500 | Server error - try again later |
Tips
- Use streaming: Enable streaming for real-time responses
- Handle errors: Implement retry logic for rate limits
- Monitor usage: Track your API usage in Settings
- Secure keys: Never expose API keys in client-side code
How is this guide?