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

Factory Droid · LLMReleased 2025-04-14

How to Use GPT-4.1 mini in Factory Droid

GPT-4.1 mini suits document extraction, focused code changes, and tasks with explicit output rules. Its 1,047,576-token context window supports large reference sets, with responses capped at 32,768 tokens.

Prompts to try with GPT-4.1 mini in Factory Droid

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

Use GPT-4.1 mini to inspect the failing test and relevant project files. Fix the underlying bug, keep edits within the affected behavior, and report the tests run and their results.

GPT-4.1 miniFactory Droid
Try asking
  • Use GPT-4.1 mini to review the current diff for violations of our documented API contract. Return a table with file, location, evidence, and suggested correction.

  • Use GPT-4.1 mini to extract configuration requirements from this project's documentation. Return structured JSON with each requirement, its source path, and whether the implementation satisfies it.

  • Use GPT-4.1 mini to add tests for the parser's documented edge cases. Follow existing test conventions and identify any behavior the documentation leaves ambiguous.

  • Use GPT-4.1 mini to compare the implementation with the migration guide. List required changes with supporting references, then prepare the smallest patch for the first confirmed incompatibility.

How to set up GPT-4.1 mini in Factory Droid

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

Use Spiral's MCP server

  1. Add the server

    Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.

    droid mcp add spiral https://api.spiral.ai/mcp --type http
  2. Sign in

    Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

  3. Check it

    Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.

    droid mcp list

Use the Spiral skill

  1. Send Factory Droid 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 GPT-4.1 mini

    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": "openai",
        "model": "openai/gpt-4.1-mini",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Factory Droid finds GPT-4.1 mini on Spiral, shows the price and runs it.

GPT-4.1 mini providers and prices

Spiral runs GPT-4.1 mini through OpenAI. Open a card for today's price, with every fee included.

OpenAIDeprecatedLLM
GPT-4.1 Mini
openai/gpt-4.1-mini

Settings you can ask for

Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Top p0 to 1
Logprobson or off
Max tokensa whole number from 16

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Presence penalty-2 to 2
Frequency penalty-2 to 2
Parallel tool callson or off

Every API field of GPT-4.1 Mini is on its tool page: open its card above.

What can you do with GPT-4.1 mini in Factory Droid?

Turn project code and documentation into focused patches, tests, and structured findings with GPT-4.1 mini. Define the scope and acceptance criteria so its instruction following serves a concrete engineering task.

Extract obligations from policy text

Use GPT-4.1 mini to turn supplied policies into a table of obligations, responsible roles, deadlines, and supporting passages. Mark missing details explicitly.

Draft answers from a support policy

Give GPT-4.1 mini the customer's question and the applicable policy. Request a short reply supported by the policy, with a clarification question when essential details are missing.

Make focused code changes

Ask GPT-4.1 mini to fix a bounded bug using the relevant code and failing test. Specify the intended behavior and require a patch with validation results.

Classify incoming requests

Use GPT-4.1 mini to assign requests to defined categories. Provide labeled examples and an explicit outcome for ambiguous requests.

Build evidence-backed research briefs

Have GPT-4.1 mini summarize supplied research excerpts with source IDs attached to each finding. Review smaller sets first when complete coverage matters.

Convert notes into structured records

Ask GPT-4.1 mini to extract decisions, owners, and deadlines from meeting transcripts. Use a defined structure and preserve uncertainty when a detail was never stated.

Compare document revisions

Supply GPT-4.1 mini with two versions of a policy or specification. Request a change table that pairs each finding with passages from both versions.

Prepare tool requests from natural language

Use GPT-4.1 mini to translate a user's request into arguments for a defined function. Require missing information to be identified before an action is requested.

Questions about GPT-4.1 mini in Factory Droid

Can Factory Droid use GPT-4.1 mini?

Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run GPT-4.1 mini like any built-in tool.

How much does GPT-4.1 mini cost in Factory Droid?

Up to $0.008539 per run at the default inputs. $0.52 per 1M input tokens, $0.13 per 1M cached input tokens, $2.08 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Factory Droid plan is separate.

Do I need an OpenAI account to use GPT-4.1 mini in Factory Droid?

No. Spiral runs GPT-4.1 mini on its own OpenAI account. You sign in to Spiral once and never paste a key.

How long does it take to set up GPT-4.1 mini in Factory Droid?

About two minutes: add the server, then sign in, then check it.

Does Factory Droid wait while GPT-4.1 mini runs?

GPT-4.1 mini runs in the background. Factory Droid starts the run, checks on it and gives you the text, json when it's ready.

How much material can GPT-4.1 mini handle?

OpenAI lists a 1,047,576-token context window. For exhaustive extraction, divide large collections into sections and check coverage, since retrieval performance can decline as more items must be found.

How long can a GPT-4.1 mini response be?

The model's maximum output is 32,768 tokens. For a long report, request an outline first, then generate sections with explicit length targets.

Where does GPT-4.1 mini need extra checking?

Tasks that require finding every relevant item across a large reference set need coverage checks. Extract evidence in smaller sections before asking for a combined conclusion.

How should I prompt GPT-4.1 mini?

State the task, permitted evidence, output format, and behavior when information is missing. Make each requirement explicit because GPT-4.1 models follow instructions literally.

Can GPT-4.1 mini produce reliable structured data?

GPT-4.1 mini supports Structured Outputs, which can enforce a supported JSON schema. Check the extracted values against the source because correct structure does not guarantee correct content.

Get started

Start using GPT-4.1 mini in Factory Droid

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

Paste this into Factory Droid:

Set up Factory Droid

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