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

Codex · LLMReleased 2026-08-12

How to Use Seed 2.1 Turbo in Codex

Seed 2.1 Turbo suits multi-step coding and document work. Compared with Seed 2.1 Pro, it scored lower on ByteDance's test of building code repositories from requirements.

Prompts to try with Seed 2.1 Turbo in Codex

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

Use Seed 2.1 Turbo with high reasoning effort to investigate the failing tests in this repository. Reproduce the failure, trace its cause, make a focused fix, and report the test results.

Seed 2.1 TurboCodex
Try asking
  • Use Seed 2.1 Turbo to implement keyboard navigation for this project's search results. Follow the existing component patterns and verify arrow keys, Enter, Escape, and focus behavior.

  • Use Seed 2.1 Turbo to read the project's requirements and implementation. List unmet acceptance criteria, implement the smallest missing feature, and verify its behavior.

  • Use Seed 2.1 Turbo with high reasoning effort to trace checkout totals across this codebase. Check rounding and discount order, fix any reproducible discrepancy, and add a regression test.

  • Use Seed 2.1 Turbo to turn this repository's feature brief into an implementation plan. Name the affected files, dependencies, acceptance criteria, and validation steps before editing.

How to set up Seed 2.1 Turbo in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. Sign in

    Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.

    codex mcp login spiral

Use the Spiral skill

  1. Send Codex 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 Seed 2.1 Turbo

    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": "openrouter",
        "model": "bytedance-seed/seed-2-1-turbo",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Codex finds Seed 2.1 Turbo on Spiral, shows the price and runs it.

Seed 2.1 Turbo providers and prices

Spiral runs Seed 2.1 Turbo through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
ByteDance Seed: Seed 2.1 Turbo
bytedance-seed/seed-2-1-turbo

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Top p0 to 1
Max tokens1 to 235929

The most output tokens to generate.

Temperature0 to 2
Frequency penalty-2 to 2

Every API field of ByteDance Seed: Seed 2.1 Turbo is on its tool page: open its card above.

What can you do with Seed 2.1 Turbo in Codex?

Seed 2.1 Turbo can carry a feature or bug fix from requirements through implementation and validation. Give it the relevant project context and define the checks that establish completion.

Fix a reproducible bug

Use Seed 2.1 Turbo to trace a reported failure, propose a patch, and check the result against a regression test.

Implement a feature from acceptance criteria

Give Seed 2.1 Turbo the requirements and constraints. Ask for an implementation plan, coordinated code changes, and evidence that each acceptance criterion passes.

Turn a project brief into a delivery plan

Ask Seed 2.1 Turbo to identify dependencies, sequence the work, and define the evidence needed to finish each milestone.

Compare competing proposals

Have Seed 2.1 Turbo compare supplied proposal text against a fixed rubric, quote supporting passages, and identify unanswered questions.

Extract document records

Use Seed 2.1 Turbo to turn document text into structured records. Specify the required structure and ask it to leave missing information explicitly unknown.

Prepare a recurring change brief

Give Seed 2.1 Turbo current and previous source text. Ask for a concise account of changes, their practical implications, and the passages supporting them.

Explain a chart

Ask Seed 2.1 Turbo to interpret a supplied chart image, distinguish visible values from estimates, and flag labels it cannot read.

Questions about Seed 2.1 Turbo in Codex

Can Codex use Seed 2.1 Turbo?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Seed 2.1 Turbo like any built-in tool.

How much does Seed 2.1 Turbo cost in Codex?

Up to $0.013336 per run at the default inputs. $0.65 per 1M input tokens, $3.25 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

Do I need an OpenRouter account to use Seed 2.1 Turbo in Codex?

No. Spiral runs Seed 2.1 Turbo on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Seed 2.1 Turbo in Codex?

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

Does Codex wait while Seed 2.1 Turbo runs?

Seed 2.1 Turbo runs in the background. Codex starts the run, checks on it and gives you the text, json when it's ready.

What is Seed 2.1 Turbo useful for?

Use it for coding tasks that involve requirements, implementation, debugging, and validation, or document work that needs several steps. Give it a concrete deliverable, such as a tested patch or a project plan with acceptance criteria.

How much context and output can Seed 2.1 Turbo handle?

Its context window is 262,144 tokens. BytePlus documents an output ceiling of 256K tokens including reasoning, so that figure is not a promise of 256K tokens of finished prose.

Can Seed 2.1 Turbo create images or videos?

Seed 2.1 Turbo returns text. It can interpret image and video inputs, making it useful for written explanations, visual analysis, and editing notes.

When should I use more reasoning?

Try high reasoning effort for debugging or planning with several constraints, and low effort for straightforward extraction. Compare the results on representative tasks before making either your default.

Where does Seed 2.1 Turbo need closer review?

ByteDance acknowledges weaknesses on the hardest open-ended tasks and frontier research problems. For those tasks, ask for testable claims, supporting evidence, and explicit unresolved questions.

Get started

Start using Seed 2.1 Turbo in Codex

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

Paste this into Codex:

Set up Codex

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