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

opencode · LLMReleased 2025-04-14

How to Use GPT-4.1 mini in opencode

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 opencode

Copy an example into opencode, 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 miniopencode
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 opencode

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

Use Spiral's MCP server

  1. Add the server

    Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

    opencode mcp add spiral --global --url https://api.spiral.ai/mcp
  2. Sign in

    Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    opencode mcp list

Use the Spiral skill

  1. Send opencode 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: opencode 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 opencode 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 opencode?

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 opencode

Can opencode use GPT-4.1 mini?

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

How much does GPT-4.1 mini cost in opencode?

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 opencode plan is separate.

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

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 opencode?

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

Does opencode wait while GPT-4.1 mini runs?

GPT-4.1 mini runs in the background. opencode 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 opencode

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

Paste this into opencode:

Set up opencode

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