Build intelligent applications with our comprehensive AI assistant API. Access conversational chat, code generation, and text-to-speech capabilities powered by advanced language models.
- Introduction
- Getting Started
- Authentication
- Rate Limits
- Chat API
- Code Generation API
- Text-to-Speech API
- Resources
The Evilly AI API provides developers with direct access to our intelligent assistant infrastructure. Powered by advanced language models and ElevenLabs, Evilly can engage in natural conversations, generate production-ready code, and provide high-quality voice synthesis.
Base URL: https://evilly.onrender.com
- Natural language chat with context-aware responses
- Professional code generation (HTML/CSS/JavaScript)
- High-quality text-to-speech with ElevenLabs
- Dual-mode operation (Chat & Code)
- Conversation history support
- Low latency responses
To get started with the Evilly AI API:
- Review the documentation for your desired endpoints
- Test the public endpoints without authentication
- For production usage, configure your environment
- Integrate the API into your application
curl -X POST https://evilly.onrender.com/api/chat \
-H "Content-Type: application/json" \
-d '{
"message": "Hello, who are you?",
"conversationHistory": [],
"mode": "chat"
}'Currently, all endpoints are public and don't require authentication for development purposes. For production deployments, you'll need to implement your own authentication layer.
The API accepts requests from:
https://evilly.xyzhttps://www.evilly.xyzhttp://localhost:3000(for development)
API rate limits help ensure fair usage:
| Environment | Requests per minute | Requirements |
|---|---|---|
| Development | Unlimited | Localhost only |
| Production | As configured | Backend rate limiting |
Engage in natural conversations with Evilly AI assistant.
Request Body:
{
"message": "What is your purpose?",
"conversationHistory": [
{ "role": "user", "content": "Hello" },
{ "role": "assistant", "content": "Hi! How can I help you?" }
],
"mode": "chat"
}Response:
{
"response": "I'm Evilly, a friendly AI assistant created to help you...",
"usage": {
"prompt_tokens": 45,
"completion_tokens": 120,
"total_tokens": 165
}
}Generate production-ready HTML, CSS, and JavaScript code.
Request Body:
{
"prompt": "Create a responsive navbar",
"conversationHistory": [],
"language": "html/css/javascript",
"mode": "code"
}Response:
{
"code": "```html\n<!DOCTYPE html>\n...\n```",
"usage": {
"prompt_tokens": 123,
"completion_tokens": 890,
"total_tokens": 1013
}
}Full Code Generation API Documentation →
Convert text to high-quality speech using ElevenLabs.
Request Body:
{
"text": "Hello, I'm Evilly!"
}Response:
Content-Type: audio/mpeg
<audio stream>
All endpoints may return error responses in the following format:
{
"error": "Message is required"
}| Status Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad Request - Invalid parameters |
| 500 | Internal Server Error |
- Keep conversation history limited (last 10 exchanges recommended)
- Handle errors gracefully and provide user feedback
- Implement proper timeout handling
- Cache responses when appropriate
- Use streaming for long responses when available
- Monitor token usage for cost optimization
Coming soon! We're working on official SDKs for:
- JavaScript/TypeScript
- Python
- Go
- Website: https://evilly.xyz
- GitHub: https://github.com/EvillyLLM/Evilly-API
- Twitter: https://x.com/EvillyLLM
- Health Check: https://evilly.onrender.com/health
For support, questions, or feature requests:
- Open an issue on GitHub
- Follow us on Twitter
- Visit our website at evilly.xyz
- Initial release
- Chat API endpoint
- Code Generation API endpoint
- Text-to-Speech API endpoint
- CORS configuration for production