# Moondream: Moondream 3.1

Generate and analyse text with Moondream: Moondream 3.1 from OpenRouter through one Spiral API key. It runs in the background and returns text and structured JSON. Pay as you go, with no subscription.

- Provider: OpenRouter
- Category: LLM
- Runs: In the background
- Returns: text, json
- Released: 2026-10-15
- Tool id: `openrouter` / `moondream/moondream3.1-9b-a2b`
- Page: https://spiral.ai/tools/openrouter/moondream/moondream3.1-9b-a2b

## Pricing

Up to $0.013327 per run at the default inputs. $0.39 per 1M input tokens, $3.25 per 1M output tokens.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `messages` (required) | JSON |  | — | The conversation so far, oldest first. |
| `top_p` | number | 0 to 1 | — |  |
| `reasoning` | JSON |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| `max_tokens` | number (whole) | 1 to 4096 | — | The most output tokens to generate. |
| `temperature` | number | 0 to 2 | — |  |
| `reasoning_effort` | text |  | — | OpenAI's reasoning effort (minimal, low, medium, high, xhigh). |

## How to use Moondream: Moondream 3.1

From your AI agent, the command line or your own code. One Spiral account runs it every way.

### Use Spiral's MCP server

1. **Add Spiral's MCP server**: Any MCP client takes https://api.spiral.ai/mcp with your API key as a Bearer token. In Claude Code:

```bash
claude mcp add spiral --transport http https://api.spiral.ai/mcp \
  --header "Authorization: Bearer $SPIRAL_API_KEY"
```

2. **Ask for Moondream: Moondream 3.1**: Your agent finds it on Spiral, shows the price and runs it.

```
Use Moondream: Moondream 3.1 from OpenRouter on Spiral.
```

### Use the Spiral skill

1. **Send your agent this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

3. **Ask for Moondream: Moondream 3.1**: Your agent finds it on Spiral, shows the price and runs it.

```
Use Moondream: Moondream 3.1 from OpenRouter on Spiral.
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

2. **Run Moondream: Moondream 3.1**: Waits for the result and saves the run and its files under .spiral/runs.

```bash
spiral runs create \
  --provider openrouter \
  --model moondream/moondream3.1-9b-a2b \
  --input '{
    "messages": [
      {
        "role": "system"
      }
    ]
  }' \
  --wait --save
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Moondream: Moondream 3.1**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "openrouter",
    "model": "moondream/moondream3.1-9b-a2b",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=openrouter&model=moondream%2Fmoondream3.1-9b-a2b

## Use Moondream: Moondream 3.1 in your AI agent

- [Amp](https://spiral.ai/integrations/amp/moondream-3-1)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/moondream-3-1)
- [Claude](https://spiral.ai/integrations/claude-desktop/moondream-3-1)
- [Claude Code](https://spiral.ai/integrations/claude-code/moondream-3-1)
- [Cline](https://spiral.ai/integrations/cline/moondream-3-1)
- [Codex](https://spiral.ai/integrations/codex/moondream-3-1)
- [Cursor](https://spiral.ai/integrations/cursor/moondream-3-1)
- [Devin](https://spiral.ai/integrations/devin/moondream-3-1)
- [dots](https://spiral.ai/integrations/dots/moondream-3-1)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/moondream-3-1)
- [Gemini](https://spiral.ai/integrations/gemini/moondream-3-1)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/moondream-3-1)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/moondream-3-1)
- [goose](https://spiral.ai/integrations/goose/moondream-3-1)
- [Grok](https://spiral.ai/integrations/grok/moondream-3-1)
- [Grok Build](https://spiral.ai/integrations/grok-build/moondream-3-1)
- [Hermes](https://spiral.ai/integrations/hermes/moondream-3-1)
- [Instinct](https://spiral.ai/integrations/instinct/moondream-3-1)
- [Manus](https://spiral.ai/integrations/manus/moondream-3-1)
- [Muse](https://spiral.ai/integrations/muse/moondream-3-1)
- [Muse Code](https://spiral.ai/integrations/muse-code/moondream-3-1)
- [n8n](https://spiral.ai/integrations/n8n/moondream-3-1)
- [Notion](https://spiral.ai/integrations/notion/moondream-3-1)
- [OpenClaw](https://spiral.ai/integrations/openclaw/moondream-3-1)
- [opencode](https://spiral.ai/integrations/opencode/moondream-3-1)
- [Perplexity](https://spiral.ai/integrations/perplexity/moondream-3-1)
- [Raycast](https://spiral.ai/integrations/raycast/moondream-3-1)
- [VS Code](https://spiral.ai/integrations/vscode/moondream-3-1)
- [Windsurf](https://spiral.ai/integrations/windsurf/moondream-3-1)
- [Zapier](https://spiral.ai/integrations/zapier/moondream-3-1)

## Provider

- [OpenRouter](https://spiral.ai/providers/openrouter)

## Related tools

- [Moondream: Moondream 3 Preview](https://spiral.ai/tools/openrouter/moondream/moondream3-preview)
- [MoonshotAI: Kimi K2 0711](https://spiral.ai/tools/openrouter/moonshotai/kimi-k2)
- [Mistral: Voxtral Small 24B 2507](https://spiral.ai/tools/openrouter/mistralai/voxtral-small-24b-2507)
- [MoonshotAI: Kimi K2 0905](https://spiral.ai/tools/openrouter/moonshotai/kimi-k2-0905)
- [Mistral: Pixtral Large 2502](https://spiral.ai/tools/openrouter/mistralai/pixtral-large-2502)
- [MoonshotAI: Kimi K2 Thinking](https://spiral.ai/tools/openrouter/moonshotai/kimi-k2-thinking)

## Common questions

### Moondream: Moondream 3.1

**How much does Moondream: Moondream 3.1 cost?**

Up to $0.013327 per run at the default inputs. $0.39 per 1M input tokens, $3.25 per 1M output tokens. It is paid from your prepaid Spiral balance as you use it, with no subscription.

**How long does Moondream: Moondream 3.1 take to run?**

It runs in the background: the request returns a run id at once, and you poll `GET /v1/runs/{id}` or name a webhook to hear when it finishes. A run can take at most 225 minutes, end to end.

**What input does Moondream: Moondream 3.1 take?**

It needs `messages`. It also takes 5 optional fields: `top_p`, `reasoning`, `max_tokens` and 2 more. Each field's type, allowed values and default are listed on this page.

**What does Moondream: Moondream 3.1 return?**

A finished run returns text and json output. Each output up to 5 GB is stored as a copy; a larger output comes back as the provider's own link where the provider gives one, and otherwise that output is not delivered and you are not charged for it; a run with nothing delivered fails as too large, without a charge.

**What are the limits of Moondream: Moondream 3.1?**

Longest queue wait: 1 hour; largest inline input: 1 MB; largest input file: 2 GB.

**How do I use Moondream: Moondream 3.1 through an API?**

Send `POST /v1/runs` with `"provider": "openrouter"`, `"model": "moondream/moondream3.1-9b-a2b"` and its input, using one Spiral API key.

**How do I see what a run of Moondream: Moondream 3.1 will cost before I start it?**

Send the same request to `POST /v1/estimate`: it prices that exact input without running it.

**What happens if a run of Moondream: Moondream 3.1 fails?**

Only for work the provider billed. A run that fails before the provider does billable work is not charged, and its hold goes back to your balance; a failure the provider bills for is charged for the work the provider billed, at the tool's price. Each failed run's error says why it failed and what it was charged.

**Do I need an account with OpenRouter to use Moondream: Moondream 3.1?**

No. Spiral runs it on its own OpenRouter account and charges your Spiral balance.

**Can my AI agent use Moondream: Moondream 3.1?**

Yes. Any agent connected to Spiral's MCP server, CLI or agent skill runs it with the same API key, and there are guides for using it from Amp, ChatGPT, Claude, Claude Code, Cline, Codex, Cursor, Devin, dots, Factory Droid, Gemini, Gemini CLI, Google Antigravity, goose, Grok, Grok Build, Hermes, Instinct, Manus, Muse, Muse Code, n8n, Notion, OpenClaw, opencode, Perplexity, Raycast, VS Code, Windsurf and Zapier.

**Can I cap what an agent spends on Moondream: Moondream 3.1?**

Yes. Give each agent its own API key with a spend cap: a run whose estimate would pass the cap is refused before it starts.

