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

Hermes · Image

How to Use Image Editing Reframe in Hermes

Image Editing Reframe adapts an existing image to a different aspect ratio while aiming to maintain the main subject. Use it to rework a photo for a banner, square tile, or portrait layout.

Prompts to try with Image Editing Reframe in Hermes

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

Every Monday, use Image Editing Reframe on each newly supplied campaign photo to prepare a square composition. Collect the originals and results in a review report.

Image Editing ReframeHermes
Try asking
  • Each morning, use Image Editing Reframe to prepare widescreen versions of newly supplied article photos, sixteen units wide by nine tall. Include each original beside its result.

  • Every Friday, use Image Editing Reframe on the week's supplied promotional images to create portrait story compositions, nine units wide by sixteen tall. Hold the results for review.

  • At the start of each month, use Image Editing Reframe on newly supplied event photos to prepare portrait poster drafts, two units wide by three tall.

  • Each week, use Image Editing Reframe to prepare extra-wide banner compositions from newly supplied campaign photos, twenty-one units wide by nine tall. Include the returned pixel dimensions in the review report.

How to set up Image Editing Reframe in Hermes

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

Use the Spiral skill

  1. Send Hermes 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 Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

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 Image Editing Reframe

    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/image-editing/reframe",
        "input": {
          "image_url": "https://v3.fal.media/files/elephant/7ekErKT--mhgKJ5kgtvU__image.webp"
        }
      }'

Then paste one of the prompts above: Hermes finds Image Editing Reframe on Spiral, shows the price and runs it.

Image Editing Reframe providers and prices

Spiral runs Image Editing Reframe through fal. Open a card for today's price, with every fee included.

falImage
Image Editing Reframe
fal-ai/image-editing/reframe

Settings you can ask for

Image Editing Reframe works from your image URL. Ask Hermes for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Guidance scale0 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 inference steps1 to 5030

Number of inference steps for sampling.

Safety tolerance1 to 62

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

Output formatjpeg or pngjpeg

The format of the generated image.

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

The desired aspect ratio for the reframed image.

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.

Every API field of Image Editing Reframe is on its tool page: open its card above.

What can you do with Image Editing Reframe in Hermes?

Prepare alternate image compositions for recurring publishing work. Have the agent reframe supplied images for each destination and collect the results for review.

Website hero images

Adapt an existing campaign photo to a wide banner, then review how the main subject fits the page.

Portrait social images

Reframe a landscape campaign image for a portrait social layout while aiming to retain the main subject.

Square product tiles

Prepare square compositions from existing product photos for a catalog or collection page.

Editorial image placements

Adapt an existing article photo to the wide and portrait placements in an editorial layout.

Presentation visuals

Rework an existing photo into a widescreen composition for a presentation slide.

Poster compositions

Turn an existing promotional image into a tall composition for a poster draft.

Questions about Image Editing Reframe in Hermes

Can Hermes use Image Editing Reframe?

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Image Editing Reframe like any built-in tool.

How much does Image Editing Reframe cost in Hermes?

$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

Do I need a fal account to use Image Editing Reframe in Hermes?

No. Spiral runs Image Editing Reframe on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Image Editing Reframe in Hermes?

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

Does Hermes wait while Image Editing Reframe runs?

Image Editing Reframe runs in the background. Hermes starts the run, checks on it and gives you the image when it's ready.

What is Image Editing Reframe useful for?

Use it to adapt an existing image to a different layout, such as turning a portrait photo into a wide banner or a landscape image into a square tile.

What does Image Editing Reframe try to preserve?

fal describes preservation of the main subject's position, composition, pose, and perspective. Compare the result with the original to decide whether it meets your needs.

How should I phrase a request for Image Editing Reframe?

Tell your agent which image to use and where the result will appear. Reframe's published schema has no text prompt input, so make the requested layout clear, such as a wide presentation image or a portrait poster.

Can I specify an exact output size in pixels?

The documentation describes aspect ratios but does not publish an exact pixel-size control or a fixed output resolution. Check the returned image's dimensions before using it in a layout with strict size requirements.

When should I choose Image Editing Reframe?

Choose it when you already have the subject and scene you want, but need a different image shape. Its documented task is changing aspect ratio while maintaining the subject.

Get started

Start using Image Editing Reframe in Hermes

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

Paste this into Hermes:

Set up Hermes

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