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

opencode · ImageReleased 2025-05-29

How to Use FLUX.1 Kontext Max Text to Image in opencode

Use FLUX.1 Kontext Max Text to Image for posters, labeled concepts, and scenes built from a written brief. Unlike FLUX.1 Kontext Max, it starts from text alone, with Max's emphasis on typography and detailed instructions.

Prompts to try with FLUX.1 Kontext Max Text to Image in opencode

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

Use FLUX.1 Kontext Max Text to Image to create a square poster concept for the project's community garden event. Show illustrated vegetables and the exact headline 'GROW TOGETHER'; inspect the lettering afterward.

FLUX.1 Kontext Max Text to Imageopencode
Try asking
  • Read the homepage copy and use FLUX.1 Kontext Max Text to Image to create a 16:9 editorial illustration of a bicycle repair bench, with warm window light and open space on the left for the page heading.

  • Read the game's character brief and use FLUX.1 Kontext Max Text to Image to create a portrait concept of its lighthouse keeper. Show a weathered yellow coat, a thoughtful expression, and a pencil illustration style.

  • Generate a product photo with FLUX.1 Kontext Max Text to Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.

  • Make four logo concepts for a coffee brand called "Northline" with FLUX.1 Kontext Max Text to Image.

How to set up FLUX.1 Kontext Max Text to Image 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 FLUX.1 Kontext Max Text to Image

    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": "fal",
        "model": "fal-ai/flux-pro/kontext/max/text-to-image",
        "input": {
          "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture…"
        }
      }'

Then paste one of the prompts above: opencode finds FLUX.1 Kontext Max Text to Image on Spiral, shows the price and runs it.

FLUX.1 Kontext Max Text to Image providers and prices

Spiral runs FLUX.1 Kontext Max Text to Image through fal. Open a card for today's price, with every fee included.

falImage
FLUX.1 Kontext [max] · Text to Image
fal-ai/flux-pro/kontext/max/text-to-image

Settings you can ask for

FLUX.1 Kontext Max Text to Image works from your prompt. Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number

The same seed and the same prompt given to the same version of the model

will output the same image every time.

Guidance scale (CFG)1 to 203.5

The CFG (Classifier Free Guidance) scale is a measure of how close you want

the model to stick to your prompt when looking for a related image to show you.

Number of images1 to 41

The number of images to generate.

Output formatjpeg or pngjpeg

The format of the generated image.

Safety tolerance1 to 62

The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.

Enhance prompton or offoff

Whether to enhance the prompt for better results.

Aspect ratio21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 and 1 more1:1

The aspect ratio of the generated image.

Every API field of FLUX.1 Kontext [max] · Text to Image is on its tool page: open its card above.

What can you do with FLUX.1 Kontext Max Text to Image in opencode?

Turn project briefs into illustrations, product concepts, and other image assets with FLUX.1 Kontext. A coding agent can use the project's content to write specific visual requests and compare results with the intended design.

Article illustrations

Create an illustration from an article brief, specifying the subject, medium, palette, and room for a separately added headline.

Product photography concepts

Explore a proposed product scene from a written description, such as a ceramic mug on a kitchen counter in soft morning light.

Event poster concepts

Generate poster artwork with a specified scene and short headline. Review the lettering before using the design.

Character concept art

Develop a character's initial appearance from a description of clothing, expression, setting, and illustration style.

Questions about FLUX.1 Kontext Max Text to Image in opencode

Can opencode use FLUX.1 Kontext Max Text to Image?

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run FLUX.1 Kontext Max Text to Image like any built-in tool.

How much does FLUX.1 Kontext Max Text to Image cost in opencode?

$0.104 per image. Billed on `num_images`, default 1. 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 a fal account to use FLUX.1 Kontext Max Text to Image in opencode?

No. Spiral runs FLUX.1 Kontext Max Text to Image on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up FLUX.1 Kontext Max Text to Image in opencode?

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

Does opencode wait while FLUX.1 Kontext Max Text to Image runs?

FLUX.1 Kontext Max Text to Image runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.

When should I choose Pro or Max?

Choose Pro for iterative visual work and a balance of speed and quality. Choose Max when typography and following detailed instructions carry more weight.

What resolution does FLUX.1 Kontext produce?

Outputs are approximately 1 megapixel. A square text-to-image result defaults to 1024 by 1024 pixels; a wider or taller shape changes the dimensions within roughly that pixel budget.

Can FLUX.1 Kontext make illustrations as well as realistic images?

Yes. Describe the intended medium, such as a photograph, pencil illustration, or painting, along with the subject and composition.

Can I rely on every word in an image being correct?

Review the result before using it. Max emphasizes typography, but FLUX.1 Kontext can still miss specific instructions.

What should I include in a visual brief?

Name the subject, setting, visual style, lighting, and composition you want. Make requirements concrete, such as a red ceramic cup on a wooden table beside a window.

Get started

Start using FLUX.1 Kontext Max Text to Image 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