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

Factory Droid · LLMReleased 2025-04-14

How to Use GPT-4.1 in Factory Droid

GPT-4.1 is useful for code edits, detailed instructions, and analysis of long documents. Its 1,047,576-token context window is much larger than its 32,768-token output limit, so ask for focused results.

Prompts to try with GPT-4.1 in Factory Droid

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

Use GPT-4.1 to investigate the failing tests in this project. Read the relevant implementation and test output, fix the underlying bug, and run the affected tests. Report the changed files and verification results.

GPT-4.1Factory Droid
Try asking
  • Use GPT-4.1 to review the current branch diff with its surrounding code. Report only actionable bugs introduced by the changes, with file locations and a concrete failure scenario. Do not edit anything.

  • Use GPT-4.1 to compare the README instructions with the implementation. Identify commands or examples that no longer match the code, then propose a unified diff limited to documentation.

  • Use GPT-4.1 to trace request validation through this repository. Identify where malformed input is accepted, propose a focused patch, and add a regression test for the demonstrated failure.

  • Use GPT-4.1 to refactor the longest duplicated validation logic in this project. Preserve public behavior, follow the existing conventions, and return a unified diff with the relevant test results.

How to set up GPT-4.1 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

    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",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

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

GPT-4.1 providers and prices

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

OpenAIDeprecatedLLM
GPT-4.1
openai/gpt-4.1

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 is on its tool page: open its card above.

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

GPT-4.1 can turn repository context into focused patches and code review findings. Give it explicit boundaries and a required diff format to guide the changes.

Focused bug fixes

Ask GPT-4.1 to trace a reported failure, change the relevant code, and return a patch with verification results.

Pull request review

Give GPT-4.1 a diff and surrounding code. Request actionable findings with a concrete failure scenario for each.

Questions across long documents

Use GPT-4.1 to locate relevant passages across supplied material and answer a narrow question with supporting excerpts.

Structured record extraction

Have GPT-4.1 turn unstructured text into records, leaving unsupported values empty and retaining evidence for review.

Policy-based response drafts

Ask GPT-4.1 to draft replies using supplied policies, explicit exceptions, and a defined response format.

Recurring source digests

Use GPT-4.1 to select relevant updates from supplied text and produce a digest with source references.

Search result ranking

Give GPT-4.1 a question and candidate passages. Request a ranked shortlist with a relevance explanation for each selection.

Constrained text rewrites

Ask GPT-4.1 to rewrite supplied text while preserving specified facts, following a length target, and avoiding named terms.

Questions about GPT-4.1 in Factory Droid

Can Factory Droid use GPT-4.1?

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

How much does GPT-4.1 cost in Factory Droid?

Up to $0.04269 per run at the default inputs. $2.60 per 1M input tokens, $0.65 per 1M cached input tokens, $10.40 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 in Factory Droid?

No. Spiral runs GPT-4.1 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 in Factory Droid?

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

Does Factory Droid wait while GPT-4.1 runs?

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

What is GPT-4.1 good at?

GPT-4.1 is useful for code editing, code review, and tasks with detailed response requirements. Its training includes following code diff formats, which makes focused patches a practical use.

How much can GPT-4.1 read and write?

The context window is 1,047,576 tokens, while one response can contain at most 32,768 output tokens. A large input allowance does not mean it can reproduce an equally large document in one answer.

Where does GPT-4.1 struggle with long documents?

Retrieving many separate details from a long context can reduce accuracy. For exhaustive extraction, split the task into smaller sections and check the combined results against the source.

How should I prompt GPT-4.1?

State the task, required format, and exceptions explicitly because GPT-4.1 interprets instructions literally. Specify what it should return when information is missing.

Does valid JSON mean GPT-4.1 extracted the right answer?

No. Structured Outputs can enforce the requested schema, but the values can still be wrong; check extracted facts against the original text.

Get started

Start using GPT-4.1 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