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

falImageAvailable nowReleased 2026-03-26

Phota · Image Editing

fal-ai/phota/edit

Edit and enhance images with Phota · Image Editing from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

$0.117 per run at the default inputs. resolution: 1K (default) $0.117, 4K $0.234. Per unit of num_images: 1K (default) $0.117, 4K $0.234.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

Text description of the desired image. To refer to specific profiles, use [[profile_id_1]], [[profile_id_2]], etc.

num_imagesnumber (whole)
1 to 4
1

Number of images to generate.

profile_idslist—

List of profile IDs to use for the image generation. Profiles may be tagged in the prompt as @Profile1, @Profile2, etc.

output_formatone of
jpeg, png
jpeg

The format of the generated image.

resolutionone of
1K, 4K
1K

Resolution of the generated image.

aspect_ratioone of
auto, 1:1, 16:9, 4:3, 3:4, 9:16
auto

Aspect ratio of the generated image.

base_modelone of
nb2, qwen-image-2, flux-2, seedream-5-pro
nb2

Base model used to render the image. Identity composes on top of whichever base model is selected, so trained profiles work with all of them. Only nb2 supports 4K.

image_urls requiredURLs or files—

List of URLs/ Base64 data URIs of the images to edit. At least one image is required; for pure text-to-image generation use the / endpoint instead. A maximum of 10 images are supported, additional images will be ignored.

Same request in code

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/phota/edit",
    "input": {
      "prompt": "Make this scene more realistic but still keep the game vibes",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'

Frequently asked questions

How much does Phota · Image Editing cost?

$0.117 per run at the default inputs. `resolution`: 1K (default) $0.117, 4K $0.234. Per unit of `num_images`: 1K (default) $0.117, 4K $0.234. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Phota · Image Editing through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/phota/edit"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Phota · Image Editing?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Phota · Image Editing?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.