Examples

Basic Generation

curl http://localhost:11434/api/generate -d '{
  "model": "qwen3:1.7b",
  "prompt": "Why is the sky blue?",
  "stream": false
}'

Streaming (default)

curl http://localhost:11434/api/generate -d '{
  "model": "qwen3:1.7b",
  "prompt": "Why is the sky blue?"
}'
Returns newline-delimited JSON chunks

With Options

curl http://localhost:11434/api/generate -d '{
  "model": "qwen3:1.7b",
  "prompt": "Write a haiku about AI",
  "stream": false,
  "options": {
    "temperature": 0.3,
    "top_p": 0.9,
    "seed": 42,
    "num_ctx": 4096
  }
}'

Structured Output (JSON Schema)

curl http://localhost:11434/api/generate -d '{
  "model": "qwen3:1.7b",
  "prompt": "What are the populations of the US and Canada?",
  "stream": false,
  "format": {
    "type": "object",
    "properties": {
      "countries": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "country": {"type": "string"},
            "population": {"type": "integer"}
          },
          "required": ["country", "population"]
        }
      }
    },
    "required": ["countries"]
  }
}'

With Thinking

curl http://localhost:11434/api/generate -d '{
  "model": "deepseek-r1:1.5b",
  "prompt": "How many r letters in strawberry?",
  "think": true,
  "stream": false
}'

With Images (Vision)

curl http://localhost:11434/api/generate -d '{
  "model": "gemma3",
  "prompt": "What is in this picture?",
  "images": ["iVBORw0KGgoAAAANSUhEUg..."],
  "stream": false
}'

Fill-in-the-Middle (Code Completion)

curl http://localhost:11434/api/generate -d '{
  "model": "qwen2.5-coder:1.5b",
  "prompt": "def compute_gcd(a, b):",
  "suffix": "    return result",
  "stream": false
}'

Preload Model (Empty Request)

curl http://localhost:11434/api/generate -d '{"model": "qwen3:1.7b"}'

Unload Model

curl http://localhost:11434/api/generate -d '{"model": "qwen3:1.7b", "keep_alive": 0}'

Keep Model Loaded Indefinitely

curl http://localhost:11434/api/generate -d '{"model": "qwen3:1.7b", "keep_alive": -1}'

mindX Integration