How to Use Luma Uni-1 Max in Codex
Luma Uni-1 Max creates new images for finished website visuals, posters, and editorial work. Compared with Luma Uni-1 Text to Image, it targets higher output quality with richer detail and stronger prompt adherence.
Prompts to try with Luma Uni-1 Max in Codex
Copy an example into Codex, or ask in your own words.
Use Luma Uni-1 Max to create a square poster for a fictional event called "NIGHT MARKET". Put that exact title at the top, a food stall in the center, and warm lantern lighting throughout.
Generate a product photo with Luma Uni-1 Max: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
Make four logo concepts for a coffee brand called "Northline" with Luma Uni-1 Max.
Create a 16:9 hero image of a quiet mountain cabin at dusk with Luma Uni-1 Max.
Generate a 9:16 poster with Luma Uni-1 Max for a jazz night called "Blue Hour", deep navy and brass tones.
How to set up Luma Uni-1 Max 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 Luma Uni-1 Max
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": "luma/agent/uni-1/v1/max", "input": { "prompt": "A manga panel of a stoic samurai overlooking a neon cyberpunk city at dusk." } }'
Then paste one of the prompts above: Codex finds Luma Uni-1 Max on Spiral, shows the price and runs it.
Luma Uni-1 Max providers and prices
Spiral runs Luma Uni-1 Max through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Luma Uni-1 Max works from your prompt and reference image URLs. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Aspect ratio | 3:1, 2:1, 16:9, 3:2, 1:1, 2:3, 9:16, 1:2 and 1 more | Aspect ratio of the generated image. | |
| Style | auto or manga | auto | Visual style of the generated image. |
| Output format | png or jpeg | Encoding format of the generated image. | |
| Enable web search | on or off | off | When true, the model may consult the web for references. |
Every API field of Luma Uni-1 Text to Image Max is on its tool page: open its card above.
What can you do with Luma Uni-1 Max in Codex?
Turn a project's visual brief into images for a website, product campaign, or storyboard. A coding agent can use project assets to guide a new composition or revise an existing image.
Product campaign images
Use product references to develop a new campaign composition, or revise an existing product shot. Keep the brief specific about the product, setting, and intended change.
Posters with short headlines
Create a poster or revise an existing layout with a brief headline in quotation marks. Keep the wording short enough to inspect easily before publication.
Storyboard development
Create a sequence of panels for a pitch, or revise an existing storyboard. Describe each panel separately and request consistent character appearance.
Website lead images
Develop a new image for the top of a website or refine an existing composition for the page. Max is useful when preparing the finished visual.
Book cover concepts
Explore a cover composition or revise a supplied cover image. Use a short quoted title and inspect the lettering before treating the image as finished.
More on Luma Uni-1 Max and Codex
Overview
Luma Uni-1 Max in other agents
Questions about Luma Uni-1 Max in Codex
Can Codex use Luma Uni-1 Max?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Luma Uni-1 Max like any built-in tool.
How much does Luma Uni-1 Max cost in Codex?
$0.0039 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 Luma Uni-1 Max in Codex?
No. Spiral runs Luma Uni-1 Max on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Luma Uni-1 Max in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Luma Uni-1 Max runs?
Luma Uni-1 Max runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.
What resolution does Luma Uni-1 produce?
Luma documents 2048-pixel, or 2K, output for Uni-1 and Uni-1 Max. Max improves output quality without increasing that documented resolution.
Can Luma Uni-1 put readable text in an image?
Yes. Put the exact wording in quotation marks and favor short headings or labels under 20 characters; long passages are less reliable.
Should I write Luma Uni-1 prompts in English?
English is the recommended choice. Luma says prompts in other languages produce less reliable results.
What does Max improve?
Uni-1 Max targets higher output quality with the same prompts and parameters. It is a useful choice when preparing a finished image or a detailed final revision.
Can Luma Uni-1 help with storyboards?
Yes. Describe the action in each panel and explicitly request the same character throughout; for revisions, identify the panels and details that should change.
Start using Luma Uni-1 Max 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


