# Gemini 3.8 Flash Media Understanding (image, video, audio, PDF)

Extract text and data from files with Gemini 3.8 Flash Media Understanding (image, video, audio, PDF) through one Spiral API key. It runs in the background and returns text. Pay as you go, with no subscription.

- Provider: Gemini
- Category: Data
- Runs: In the background
- Returns: text
- Released: 2026-09-02
- Tool id: `gemini` / `gemini-3.8-flash`
- Page: https://spiral.ai/tools/gemini/gemini-3.8-flash

## Pricing

Up to $2.6837 per run at the default inputs. $1.95 per 1M input tokens, $0.195 per 1M cached input tokens, $9.75 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 |
| --- | --- | --- | --- | --- |
| `contents` (required) | JSON |  | — | The conversation: usually one user turn with the instruction and the media parts. |
| `generationConfig` | JSON |  | — | Generation settings. |
| `systemInstruction` | JSON |  | — | Instructions for the model's behaviour. |

## Example

```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": "gemini",
    "model": "gemini-3.8-flash",
    "input": {
      "contents": [
        {
          "parts": [
            {}
          ]
        }
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=gemini&model=gemini-3.8-flash

## Common questions

### Gemini 3.8 Flash Media Understanding (image, video, audio, PDF)

**How much does Gemini 3.8 Flash Media Understanding (image, video, audio, PDF) cost?**

Up to $2.6837 per run at the default inputs. $1.95 per 1M input tokens, $0.195 per 1M cached input tokens, $9.75 per 1M output tokens. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Gemini 3.8 Flash Media Understanding (image, video, audio, PDF) through an API?**

Send `POST /v1/runs` with `"provider": "gemini"`, `"model": "gemini-3.8-flash"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Gemini to use Gemini 3.8 Flash Media Understanding (image, video, audio, PDF)?**

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

**Can my AI agent use Gemini 3.8 Flash Media Understanding (image, video, audio, PDF)?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

