Spiral gives your agent every tool with one account. Browse the tools →

Grok · Data

How to Use Gemini content classification in Grok

Gemini evaluates supplied text, images, audio, video, or PDFs and returns yes/no probabilities, category decisions, or rubric scores. Use it to classify content or grade evidence against explicit rules.

Prompts to try with Gemini content classification in Grok

Copy an example into Grok, or ask in your own words.

Retrieve NASA's latest Perseverance announcement, then use Gemini content classification to choose science finding, rover operations, mission planning, or other. Show the probability for each category.

Gemini content classificationGrok
Try asking
  • Retrieve Apple's latest annual report risk factors, then use Gemini content classification to score relevance to supply chain research from 0 for unrelated to 3 for directly relevant. Show the score and probabilities.

  • Retrieve Stripe's webhook documentation, then use Gemini content classification to estimate whether the text supports the claim 'Webhook event delivery order is guaranteed.' Show the probability of yes.

  • Retrieve Python's Errors and Exceptions tutorial, then use Gemini content classification to score its treatment of recovery from 0 for absent to 3 for demonstrated with an example. Show the rubric result.

  • Retrieve five recent pandas-dev/pandas issue reports, then use Gemini content classification on each report to choose documentation, installation, runtime error, or other. Compare the candidate probabilities.

How to set up Gemini content classification in Grok

Pick the way that suits you. Each takes about two minutes.

Use the Grok connector

  1. Add a custom connector

    In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

    https://api.spiral.ai/mcp
  2. Sign in to Spiral and approve

    Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

  3. Check that it is connected

    Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

Use the Spiral skill

  1. Send Grok 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.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Gemini content classification

    One request; the result comes back by polling or a webhook.

    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-decision-1",
        "input": {
          "input": "<input>",
          "questions": {}
        }
      }'

Then paste one of the prompts above: Grok finds Gemini content classification on Spiral, shows the price and runs it.

Gemini content classification providers and prices

Spiral runs Gemini content classification through Gemini. Open a card for today's price, with every fee included.

GeminiData
Gemini Decision 1
gemini-decision-1

What can you do with Gemini content classification in Grok?

Sort public documents into a research shortlist with category probabilities and rubric scores. Gemini can evaluate supplied announcements, filing excerpts, and technical documentation against the same stated criteria.

Route public bug reports

Classify supplied issue text into documentation, installation, runtime error, or other, then use candidate probabilities to prioritize review.

Sort research announcements

Assign supplied NASA announcements to mission updates, research findings, launch operations, or other for an editorial queue.

Grade documentation coverage

Score a supplied technical guide against defined levels for prerequisites, examples, error handling, and troubleshooting.

Label public product photos

Evaluate supplied catalog images for visible packaging, product views, and background characteristics using separate yes/no questions.

Check claims against supplied evidence

Pair a draft product claim with its technical documentation and estimate whether the supplied evidence supports the claim.

Triage public company disclosures

Classify supplied filing excerpts by operational, regulatory, cybersecurity, or supply chain risk and score relevance to a defined research brief.

Questions about Gemini content classification in Grok

Can Grok use Gemini content classification?

Yes. Add Spiral to Grok as an MCP server, and Grok can find and run Gemini content classification like any built-in tool.

How much does Gemini content classification cost in Grok?

Input $0.13 per 1M tokens; no output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Grok plan is separate.

Do I need a Gemini account to use Gemini content classification in Grok?

No. Spiral runs Gemini content classification on its own Gemini account. You sign in to Spiral once and never paste a key.

How long does it take to set up Gemini content classification in Grok?

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

Does Grok wait while Gemini content classification runs?

Gemini content classification runs in the background. Grok starts the run, checks on it and gives you the json when it's ready.

Where does the content being evaluated come from?

You supply the content Gemini evaluates. Google documents support for text, images, audio, video, and PDFs in one shared input.

How much content can Gemini evaluate in one request?

Google documents a context limit of 256K tokens and up to 1,000 independent questions against the shared input.

Does a yes/no result include uncertainty?

Gemini returns an estimated probability of yes between 0.01 and 0.99, plus confidence. The API leaves the decision cutoff to your application.

Is a rubric score always a whole number?

The returned score is a probability-weighted average, so it can fall between rubric levels. The response also includes the legend, probabilities, and confidence.

Can a request return no classifications?

Yes. Google's reference states that blocked input returns no answers.

Get started

Start using Gemini content classification in Grok

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Grok:

Set up Grok

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options