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

Grok · ImageReleased 2025-09-09

How to Use Seedream 4.0 Edit in Grok

Use Seedream 4.0 Edit to change an existing image or carry a reference character, product, or style into a new scene. Choose it over Text to Image when the result needs to follow supplied visuals.

Prompts to try with Seedream 4.0 Edit in Grok

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

Use Seedream 4.0 Edit on the attached room photograph. Change the sofa fabric to forest green and replace the curtains with white linen. Keep the camera view unchanged and return a 2048 × 2048 image.

Seedream 4.0 EditGrok
Try asking
  • Use Seedream 4.0 Edit with my two attached references. Take the bicycle from the first image and place it on the street in the second image. Request a 2048 × 2048 scene with soft morning light.

  • Remove the background from the photo I attach with Seedream 4.0 Edit and give me a transparent PNG.

  • Use Seedream 4.0 Edit to clean up these product shots so they sit on pure white.

  • Edit this image with Seedream 4.0 Edit: keep the subject, swap the background for a sunlit studio.

How to set up Seedream 4.0 Edit in Grok

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

Use the Grok connector

  1. Add a custom connector

    In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

    https://api.spiral.ai/mcp
  2. Sign in to Spiral and approve

    Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

  3. Check that it is connected

    Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

Use the Spiral skill

  1. Send Grok 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 Seedream 4.0 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/bytedance/seedream/v4/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: Grok finds Seedream 4.0 Edit on Spiral, shows the price and runs it.

Seedream 4.0 Edit providers and prices

Spiral runs Seedream 4.0 Edit through fal. Open a card for today's price, with every fee included.

falImage
Bytedance Seedream V4 Edit · Seedream 4.0 Edit
fal-ai/bytedance/seedream/v4/edit

Settings you can ask for

Seedream 4.0 Edit works from your prompt and image URLs. Ask Grok for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Number of images1 to 61

Number of separate model generations to be run with the prompt.

Max images1 to 61

If set to a number greater than one, enables multi-image generation. The model will potentially return up to max_images images every generation, and in total, num_images generations will be carried out. In total, the number of images generated will be between num_images and max_images*num_images. The total number of images (image inputs + image outputs) must not exceed 15

Seeda whole number

Random seed to control the stochasticity of image generation.

Enhance prompt modestandard or faststandard

The mode to use for enhancing prompt enhancement. Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality results but takes less time to generate.

Every API field of Bytedance Seedream V4 Edit · Seedream 4.0 Edit is on its tool page: open its card above.

What can you do with Seedream 4.0 Edit in Grok?

Turn a conversation about a poster, illustration, or story into a concrete visual draft. Supplied images can guide edits, while a written brief can define a new scene or matching series.

Storyboard a short scene

Request four related images with one character and one visual style. Describe each scene separately: arrival, discovery, decision, and departure.

Develop a poster concept

Specify the poster's purpose, subject, layout, and exact headline. Use a 2048 × 2048 square for a first composition or request a larger image when the design needs more space.

Revise an existing visual

Use Edit with a supplied image and a concrete instruction, such as replacing a background or changing an object's color. Name the target object directly.

Create a coordinated illustration set

Describe a shared palette, medium, and recurring subject, then request a small series. Give each image a distinct scene while repeating the visual requirements.

Combine visual references

Supply references for a character, setting, or style and explain the intended result. State which visual elements each reference contributes.

Explore a new composition from text

Start with a written brief for an illustration or poster. Specify the subject's position, the environment, and the direction of light.

Questions about Seedream 4.0 Edit in Grok

Can Grok use Seedream 4.0 Edit?

Yes. Add Spiral to Grok as an MCP server, and Grok can find and run Seedream 4.0 Edit like any built-in tool.

How much does Seedream 4.0 Edit cost in Grok?

$0.039 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 Grok plan is separate.

Do I need a fal account to use Seedream 4.0 Edit in Grok?

No. Spiral runs Seedream 4.0 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 Seedream 4.0 Edit in Grok?

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

Does Grok wait while Seedream 4.0 Edit runs?

Seedream 4.0 Edit runs in the background. Grok starts the run, checks on it and gives you the image when it's ready.

When should I choose Edit instead of Text to Image?

Choose Edit when you have a source image or visual references to follow. Choose Text to Image when your starting point is a written description; both use Seedream 4.0's shared generation and editing architecture.

How large can Seedream 4.0 images be?

The model supports up to 4K, including a 4096 × 4096 square. Custom dimensions must satisfy both the total pixel limit and the aspect ratio limit.

Can it create a matching series of images?

Yes. Related image sequences are a documented use for storyboards, comics, and coordinated designs. Describe the shared character and style, then specify what changes in each image.

How should I request text inside an image?

Put the exact wording in double quotation marks and state its role, such as the poster title or product label. For example, request a poster with the title "Weekend pottery".

Do longer prompts produce better results?

Very long prompts can cause the model to overlook details. BytePlus recommends staying under 600 English words; start with the subject, action, and setting, then add the visual requirements that matter.

Get started

Start using Seedream 4.0 Edit in Grok

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

Paste this into Grok:

Set up Grok

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