How to Use fal Expression Change in Codex
fal Expression Change edits facial expressions in existing photos, from smiles to serious looks. Use it to explore how a different expression changes a portrait's mood.
Prompts to try with fal Expression Change in Codex
Copy an example into Codex, or ask in your own words.
Use fal Expression Change on the presenter portrait in this project to request a slight closed-mouth smile. Ask to preserve the pose and background, then show the original and edit in our thumbnail component.
Use fal Expression Change on our demo profile portrait to make a serious expression with relaxed eyebrows. Add the result to a local preview beside the current profile image.
Use fal Expression Change to make separate smiling and serious edits of the project's reference portrait. Show both in the campaign page preview so I can compare their fit with the headline.
Use fal Expression Change on the staged customer portrait in our training assets. Request a concerned expression, ask to retain the original surroundings, and preview the result in the scenario screen.
Use fal Expression Change to compare two guidance settings on our sample portrait with the same prompt: a slight, closed-mouth smile. Keep the other settings fixed and build a comparison view labeled with the guidance values.
How to set up fal Expression Change in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex 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 fal Expression Change
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/expression-change", "input": { "image_url": "https://v3.fal.media/files/zebra/hAjCkcyly4gsS9-cptD3Y_image%20(20).png" } }'
Then paste one of the prompts above: Codex finds fal Expression Change on Spiral, shows the price and runs it.
fal Expression Change providers and prices
Spiral runs fal Expression Change through fal. Open a card for today's price, with every fee included.
Settings you can ask for
fal Expression Change works from your image URL and expression prompt. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Guidance scale | 0 to 20 | 3.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 steps | 1 to 50 | 30 | Number of inference steps for sampling. |
| Safety tolerance | 1 to 6 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 6 being the most permissive. |
| Output format | jpeg or png | jpeg | The format of the generated image. |
| Aspect ratio | 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 and 1 more | The aspect ratio of the generated image. | |
| Seed | a 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 Expression Change is on its tool page: open its card above.
What can you do with fal Expression Change in Codex?
Expression Change lets you explore portrait expressions for interfaces and visual content in your project. Have the coding agent place the results in the actual layout so you can judge the expression at its intended display size.
Profile photo expression studies
Try a slight smile and a serious expression on an existing portrait before selecting a profile image.
Thumbnail expression tests
Explore smiling and serious edits of a presenter photo, then compare them in the intended thumbnail layout.
Photo storyboard planning
Use a reference portrait to explore the expressions needed for different moments in a scene.
Campaign portrait drafts
Test whether a welcoming smile or a reserved expression better matches a campaign's message.
Training scenario illustrations
Create expression edits of a staged portrait for draft customer service or workplace communication scenarios.
Photography mood boards
Explore expression directions on a reference photo before briefing a portrait shoot.
More on fal Expression Change and Codex
Overview
fal Expression Change in other agents
Questions about fal Expression Change in Codex
Can Codex use fal Expression Change?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run fal Expression Change like any built-in tool.
How much does fal Expression Change cost in Codex?
$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need a fal account to use fal Expression Change in Codex?
No. Spiral runs fal Expression Change on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up fal Expression Change in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while fal Expression Change runs?
fal Expression Change runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.
What is Expression Change useful for?
Expression Change edits facial expressions in existing photos. Try it when choosing between a welcoming smile and a serious look for a portrait.
How should I describe the expression?
Start with one expression and its intensity, such as a slight smile or a stern look. Add visible details, such as a closed mouth or relaxed eyebrows, when you want a more specific result.
Which setting matters when the expression misses the prompt?
Guidance scale controls how closely Expression Change follows your prompt. Compare two guidance settings while keeping the source photo and wording fixed, then inspect the face before choosing.
Can I reproduce an edit?
The documentation describes repeatable output with the same seed, prompt, and model version. For a controlled comparison, also keep the source photo and other settings unchanged.
What should I check before using an edited portrait?
Compare it with the original at full size, paying attention to the eyes, teeth, facial outline, and surrounding scene. Keep only edits that preserve the details you need and communicate the intended expression.
Start using fal Expression Change in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


