# Phota Text to Image

Generate 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.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image
- Tool id: `fal` / `fal-ai/phota`
- Page: https://spiral.ai/tools/fal/fal-ai/phota

## Pricing

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

## Limits

- 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 | Allowed | 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 `nb2` supports `4K`. |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fphota

## Common questions

### Phota Text to Image

**How much does Phota Text to Image cost?**

$0.117 per run at the default inputs. `resolution`: 1K (default) $0.117, 4K $0.234. $0.117 per unit of `num_images`. 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.

