Status: [UNTESTED]
Endpoints found:
https://mlvoca.com/api/generate
Source: https://github.com/mlvoca/free-llm-api
# mlvoca.com
## A free LLM API
This API provides access to a publicly hosted `/api/generate` endpoint based on the Ollama API, enabling text generation through various models.
## Base URL
```
https://mlvoca.com
```
## Endpoint: Generate a Completion
### **POST** `/api/generate`
Generates a response based on a given prompt using a specified model. It supports both streaming and single-response generation.
### Available Models
- TinyLlama
- DeepSeek R1 (1.5b)
### Request Parameters
Accepts the following parameters:
- **`model` (required)** - The model name used for generation (can be `"tinyllama"` or `"deepseek-r1:1.5b"`).
- **`prompt` (required)** - The input prompt for text generation.
- **`suffix`** - Text appended after the model response.
- **`format`** - Specifies the response format (`"json"` or JSON schema).
- **`options`** - Additional model parameters (e.g., `"temperature"`).
- **`system`** - System message override.
- **`template`** - Custom prompt template.
- **`stream`** - If `false`, returns a single response instead of a stream.
- **`raw`** - If `true`, bypasses formatting and applies the full prompt.
- **`keep_alive`** - Duration the model remains loaded in memory (default: `"5m"`).
### Example Usage
#### Shell commands for API requests:
Shell command with streaming enabled:
```sh
curl -X POST https://mlvoca.com/api/generate -d '{
"model": "deepseek-r1:1.5b",
"prompt": "Why is the sky blue?"
}'
```
Shell command without streaming:
```sh
curl -X POST https://mlvoca.com/api/generate -d '{
"model": "tinyllama",
"prompt": "Why is the sky blue?",
"stream": false
}'
```
### Example Responses
#### Streaming response:
```
{"model":"deepseek-r1:1.5b","created_at":"2025-05-09T21:27:21.05