How to Use Product Photography in Windsurf
Product Photography turns an existing product image into a studio shot with realistic lighting and backgrounds. It suits product listings and catalog images, with output described as 4K.
Prompts to try with Product Photography in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Product Photography on the mug image in this project and add the result to a review page beside the original.
Use Product Photography on the candle asset and preview the result in the existing product card.
Use Product Photography for each product image in the collection manifest and build a comparison gallery.
Use Product Photography on the backpack asset, record the returned dimensions, and preview it in the product detail layout.
Use Product Photography on the soap image and add a side-by-side review view for its label and outline.
How to set up Product Photography in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf 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 Product Photography
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-apps-v2/product-photography", "input": { "product_image_url": "https://v3.fal.media/files/tiger/WqtPStHkOu6W0lZcIlXD8_156e3c91cb3a4d12b7380cc43b5e4c67.png" } }'
Then paste one of the prompts above: Windsurf finds Product Photography on Spiral, shows the price and runs it.
Product Photography providers and prices
Spiral runs Product Photography through fal. Open a card for today's price, with every fee included.
What can you do with Product Photography in Windsurf?
Create studio product shots from images already in your storefront project. Your coding agent can prepare a review gallery beside the originals before updating the site.
Store listing images
Turn an existing product photo into a studio shot, then review it against the item before adding it to a listing.
Wholesale catalogs
Create product photographs from supplied item images for a buyer catalog. Check each result before laying out the pages.
Product launch emails
Generate a studio shot from the launch product photo and place approved copy around it in the email design.
Social product posts
Prepare a product photograph from an existing item image for a social post. Add captions separately after reviewing the result.
Sales presentations
Use supplied product photos to prepare studio images for a sales deck, keeping product specifications in separate text.
Storefront design previews
Generate product shots from existing assets to preview a collection page before selecting the final images.
More on Product Photography and Windsurf
Overview
Product Photography in other agents
Questions about Product Photography in Windsurf
Can Windsurf use Product Photography?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Product Photography like any built-in tool.
How much does Product Photography cost in Windsurf?
$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need a fal account to use Product Photography in Windsurf?
No. Spiral runs Product Photography on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Product Photography in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Product Photography runs?
Product Photography runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.
What is Product Photography best used for?
It creates studio product shots with realistic lighting and backgrounds. Consider it for listing images, catalog pages, and product presentations.
Can Product Photography create a product from a written description?
An existing product image is required. The documented schema does not expose a text prompt.
Can I request a specific background or lighting arrangement?
The published schema provides no written scene instructions or lighting controls. Treat the generated staging as something to review rather than an exact creative brief.
What resolution does Product Photography produce?
The documentation describes the output as 4K. It does not give an exact width and height for every composition, so check the returned image before planning a crop or print layout.
How should I review a generated product shot?
Compare it with the source photo before publishing. Check the product outline, color, label text, and small details, then reject anything that misrepresents the item.
Start using Product Photography in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md



