How to Use Seedream 5.5 in Cursor
Seedream 5.5 turns text prompts into images, including transparent PNG assets for your project. In Cursor, use it for a landing page illustration, a product scene, or several visual directions to compare.
Prompts to try with Seedream 5.5 in Cursor
Copy an example into Cursor, or ask in your own words.
Read the homepage component and theme files. Use Seedream 5.5 to generate three hero illustration options with num_images=3, image_size={"width":1536,"height":1024}, and output_format=png. Show a sculptural paper forest using the project's colors, with the main subject on the right and quiet space on the left for our HTML headline. No lettering. Save the options in public/images/hero-options for review.
Read the empty-state component and project colors. Use Seedream 5.5 to create a single folded-paper compass illustration with image_size={"width":1024,"height":1024}, background=transparent, and output_format=png. Center the entire object with generous margins, no lettering, and no ground plane. Save it in public/images and add it to the empty state.
Use Seedream 5.5 to create a fictional coffee packaging image for our design demo. Render a matte green bag on a walnut table in soft window light, with the exact words 'FIELD NOTES' and 'Whole bean coffee' on the label. Set image_size={"width":1024,"height":1536}, background=opaque, and output_format=png. Save it in public/images and show it in the product card so I can inspect the lettering at its displayed size.
Read the landing page's image container dimensions. Check whether a 1600 by 900 image will fit without cropping the subject, then use Seedream 5.5 to generate a realistic ceramic desk organizer on a pale gray tabletop. Use soft side lighting, visible ceramic texture, and no text. Set image_size={"width":1600,"height":900}, background=opaque, and output_format=png. Save the image in public/images and preview it in the existing container.
Generate a product photo with Seedream 5.5: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
How to set up Seedream 5.5 in Cursor
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to Cursor on the console's Agents & MCP page, or add this to .cursor/mcp.json (one project) or ~/.cursor/mcp.json (every project):
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.
Use the Spiral skill
- Send Cursor this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Seedream 5.5
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": "bytedance/seedream/v5.5/text-to-image", "input": { "prompt": "Vibrant editorial of a model in contemporary fashion fused with West African textile patterns and beadwork, Campbell Addy bold aesthetic, saturated palette,…" } }'
Then paste one of the prompts above: Cursor finds Seedream 5.5 on Spiral, shows the price and runs it.
Seedream 5.5 providers and prices
Spiral runs Seedream 5.5 through fal. Open a card for today's price, with every fee included.
$0.05265 per run at the default inputs. $0.05265 per unit of num_images.
Settings you can ask for
Seedream 5.5 works from your prompt. Ask Cursor for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of images | 1 to 6 | 1 | Number of separate model generations to run with the prompt. |
| Output format | jpeg or png | png | The file format of the generated image. |
| Watermark | on or off | off | Whether to add the provider's visible watermark. |
| Background | auto, opaque, or transparent | auto |
|
Every API field of Seedream 5.5 Text to Image is on its tool page: open its card above.
What can you do with Seedream 5.5 in Cursor?
Ask Cursor to turn your project's colors, layout dimensions, and content into an image brief. Then request an asset for a specific component and preview it in the actual layout before choosing it.
Hero artwork sized for the component
Start with the layout's dimensions and text placement. Request artwork with the subject positioned around that space, then review the result inside the page.
Transparent illustrations for interface states
Create a standalone object for an empty state or onboarding screen. Preview its edges against both light and dark surfaces before committing the asset.
Packaging concepts in product cards
Try a fictional product scene with material, lighting, and label instructions. Inspect the lettering and crop at the card's actual display size.
Visual options reviewed in context
Generate several options from one brief and compare them in the same component. Choose based on composition, crop, and fit with the project's colors.
Photographic scenes for content pages
Request a scene with explicit materials and lighting, then preview it beside the page's typography. Keep essential headings and calls to action in HTML.
Illustrated assets for a design demo
Use a written brief for a fictional product or setting, then place the result in the demo's existing layout for review.
More on Seedream 5.5 and Cursor
Overview
Questions about Seedream 5.5 in Cursor
Can Cursor use Seedream 5.5?
Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Seedream 5.5 like any built-in tool.
How much does Seedream 5.5 cost in Cursor?
$0.05265 per run at the default inputs. $0.05265 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 Cursor plan is separate.
Do I need a fal account to use Seedream 5.5 in Cursor?
No. Spiral runs Seedream 5.5 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 5.5 in Cursor?
About two minutes: add the hosted server, then sign in.
Does Cursor wait while Seedream 5.5 runs?
Seedream 5.5 runs in the background. Cursor starts the run, checks on it and gives you the image when it's ready.
Can Seedream 5.5 generate transparent backgrounds?
Yes. Set background=transparent and output_format=png to request an RGBA image.
What image sizes does Seedream 5.5 support?
The fal endpoint accepts images totaling 921,600 to 4,624,220 pixels, with aspect ratios between 1:16 and 16:1. Check both total pixels and aspect ratio when choosing dimensions.
Can Seedream 5.5 render text on packaging?
ByteDance reports improved small-text generation and layout. Put the exact label wording in your prompt, then proofread the output at its intended display size.
Can I generate multiple Seedream 5.5 images from one prompt?
Yes, this endpoint supports batch generation. Use it to compare compositions from the same brief before choosing an asset for your component.
How should I prompt Seedream 5.5 for a website hero?
Specify the subject, materials, lighting, colors, and where the page's headline will sit. Ask for quiet space around that headline area and preview the image in the actual component.
Start using Seedream 5.5 in Cursor
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Cursor:
set up https://spiral.ai/SKILL.md