Phota Text to Image
fal-ai/photaGenerate images from text with Phota Text to Image 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
| Field | Kind | Default | Description |
|---|---|---|---|
prompt required | text | — | Text description of the desired image. In case you wish to use specific profiles, refer to them as [[profile_id_1]], [[profile_id_2]], etc. |
num_images | number (whole) 1 to 4 | 1 | Number of images to generate. |
output_format | one of jpeg, png | jpeg | The format of the generated image. |
resolution | one of 1K, 4K | 1K | Resolution of the generated image. |
aspect_ratio | one of auto, 1:1, 16:9, 4:3, 3:4, 9:16 | auto | Aspect ratio of the generated image. |
base_model | one 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 |
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",
"input": {
"prompt": "Middle Eastern man in traditional clothing sitting in a cool tent in the desert with a laptop"
}
}'Frequently asked questions
How much does Phota Text to Image 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 Text to Image through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/phota"` 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 Text to Image?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Phota Text to Image?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.