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

Factory Droid · ImageReleased 2025-10-06

How to Use GPT Image 1 Mini Edit in Factory Droid

Revise an existing image using written instructions and image references. Choose it for changes to a scene or subject; the text-to-image version creates an image from a written brief.

Prompts to try with GPT Image 1 Mini Edit in Factory Droid

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

Use GPT Image 1 Mini Edit on the project's current onboarding illustration. Change the backpack from red to forest green while preserving the character's face, pose, clothing, and framing. Save a new 1024 × 1024 PNG for review.

GPT Image 1 Mini EditFactory Droid
Try asking
  • Use GPT Image 1 Mini Edit on the project's landscape cover image. Replace the cloudy sky with a pale morning sky while preserving the buildings, camera angle, and foreground. Return a 1536 × 1024 PNG and inspect it for unintended changes.

  • Remove the background from the photo I attach with GPT Image 1 Mini Edit and give me a transparent PNG. Save the result in ./assets.

  • Use GPT Image 1 Mini Edit to clean up these product shots so they sit on pure white.

  • Edit this image with GPT Image 1 Mini Edit: keep the subject, swap the background for a sunlit studio.

How to set up GPT Image 1 Mini Edit 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 Image 1 Mini Edit

    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/gpt-image-1-mini/edit",
        "input": {
          "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
          "image_urls": [
            "<image_urls>"
          ]
        }
      }'

Then paste one of the prompts above: Factory Droid finds GPT Image 1 Mini Edit on Spiral, shows the price and runs it.

GPT Image 1 Mini Edit providers and prices

Spiral runs GPT Image 1 Mini Edit through fal. Open a card for today's price, with every fee included.

falImage
GPT Image 1 Mini · Edit
fal-ai/gpt-image-1-mini/edit

Settings you can ask for

GPT Image 1 Mini Edit works from your prompt and image URLs. Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Image sizeauto, 1024x1024, 1536x1024, or 1024x1536auto

Aspect ratio for the generated image

Backgroundauto, transparent, or opaqueauto

Background for the generated image

Qualityauto, low, medium, or highauto

Quality for the generated image

Number of images1 to 41

Number of images to generate

Output formatjpeg, png, or webppng

Output format for the images

Every API field of GPT Image 1 Mini · Edit is on its tool page: open its card above.

What can you do with GPT Image 1 Mini Edit in Factory Droid?

Create image assets that fit the project you are building. Have the agent read the design brief, generate artwork at a supported size, and inspect it before adding it to the interface.

Game asset concepts

Try a square inventory illustration of a single object with a transparent background. Review its silhouette at the size it will appear in the game.

Editorial illustrations

Turn an article's main idea into a landscape illustration. Specify the subject and visual medium, and leave space for a headline added separately.

Scene revisions

Use Edit to try a different object color or background in an existing image. State which details should stay, then check for unintended changes.

Portrait artwork

Create a 1024 × 1536 illustration for a cover concept or poster. Keep exact typography as a separate design task.

Visual direction studies

Describe the same subject in watercolor, paper collage, and pencil. Compare the results before choosing a direction for the finished artwork.

Product image variations

Use a product image as an editing reference to explore a different setting. Inspect the product's shape and labels before accepting the result.

Questions about GPT Image 1 Mini Edit in Factory Droid

Can Factory Droid use GPT Image 1 Mini Edit?

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

How much does GPT Image 1 Mini Edit cost in Factory Droid?

Up to $0.0676 per run at the default inputs. `quality`: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676. $0.0676 per unit of `num_images`. 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 a fal account to use GPT Image 1 Mini Edit in Factory Droid?

No. Spiral runs GPT Image 1 Mini Edit on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up GPT Image 1 Mini Edit in Factory Droid?

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

Does Factory Droid wait while GPT Image 1 Mini Edit runs?

GPT Image 1 Mini Edit runs in the background. Factory Droid starts the run, checks on it and gives you the image when it's ready.

What is the difference between GPT Image 1 Mini and GPT Image 1 Mini Edit?

The generation version creates a new image from a written prompt. Edit uses existing images as references alongside your instructions.

What image sizes can it produce?

Use 1024 × 1024 pixels for square images, 1536 × 1024 for landscape, or 1024 × 1536 for portrait.

Can it make images with transparent backgrounds?

Yes. Request a transparent background and save the result as PNG or WebP.

Can I trust text inside the generated image?

Check every word and its placement before using the image. For artwork that needs exact typography, consider generating the illustration first and adding the text in your design tool.

Will a character look identical across several images?

Separate generations can change a character's appearance or brand details. Try editing an approved reference, then compare each result against it.

Get started

Start using GPT Image 1 Mini Edit 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