# Phota (`phota`)

> Phota image generation. High-quality photorealistic output.

- Capability: Images (tool `image`) — Text to image
- Price: from $0.09 per run (1 credit = $0.01). Exact price for a request: POST https://api.varg.ai/v2/estimate
- Typical time: ~15 s
- JSON Schema: https://api.varg.ai/v2/tools/image?model=phota (public, no key)
- Try it: https://varg.ai/dashboard/tools/playground?model=phota

## Call it

REST: `POST https://api.varg.ai/v2/tools/image/call` with `Authorization: Bearer $VARG_API_KEY` (create a key at https://varg.ai/dashboard/api).
It answers `202` with a job right away. Poll `GET /v2/jobs/{id}` until `status` is `completed`, then read `output.outputs[0].url` — or pass `options.webhook_url` and get the finished job POSTed to you.

```bash
curl -X POST https://api.varg.ai/v2/tools/image/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "phota",
  "prompt": "Adult woman mid-20s, long platinum-blonde hair slicked back into a tight low bun with clean center part and a few baby hairs. Fair skin with light tan, natural texture with visible pores and light freckles across nose and upper cheeks. Almond-shaped light grey-hazel eyes, soft feminine face with high prominent cheekbones, defined jawline with slightly pointed chin. Wearing a black zip-up cotton hoodie zipped to upper chest with visible silver zipper, relaxed streetwear fit. Rectangular slim black sunglasses with dark lenses. White wired earphones hanging down the front splitting at chest level. Small colorful star stickers on cheeks — one green, one pink — below the sunglasses line. Single brown backpack strap over one shoulder. Long almond nude cream manicure nails. Holding a large clear plastic cup with pale green iced drink, ice pieces, flat lid, dark green straw inserted between slightly parted lips as if sipping. Left hand holds the cup near shoulder height close to camera so it appears large in foreground, fingers wrapped around cup, nails clearly visible. Outdoor low-angle selfie, subject filling most of the frame, head upright with slight forward tilt, neutral slightly unimpressed expression, deadpan selfie vibe. Outside under a leafy tree, tree trunk on left edge, dense green leaves overhead, bright blue sky behind. Natural daylight with mild backlight, sun filtered by leaves creating rim light around hairline and subtle glow on cup lid, dappled leaf light in background. iPhone selfie camera, 1x wide 26mm equivalent, slightly low angle pointing upward emphasizing sky and leaves. Vertical 9:16 tight portrait, face centered, cup dominates left-lower quadrant. Sharp focus on lips straw sunglasses stickers and nails, background leaves slightly softer. Photorealistic.",
  "aspect_ratio": "9:16"
}'
```

MCP: the varg server `https://mcp.varg.ai/mcp` (OAuth sign-in, no key) runs it with `call_tool`:

```json
{
  "tool": "image",
  "input": {
    "model": "phota",
    "prompt": "Adult woman mid-20s, long platinum-blonde hair slicked back into a tight low bun with clean center part and a few baby hairs. Fair skin with light tan, natural texture with visible pores and light freckles across nose and upper cheeks. Almond-shaped light grey-hazel eyes, soft feminine face with high prominent cheekbones, defined jawline with slightly pointed chin. Wearing a black zip-up cotton hoodie zipped to upper chest with visible silver zipper, relaxed streetwear fit. Rectangular slim black sunglasses with dark lenses. White wired earphones hanging down the front splitting at chest level. Small colorful star stickers on cheeks — one green, one pink — below the sunglasses line. Single brown backpack strap over one shoulder. Long almond nude cream manicure nails. Holding a large clear plastic cup with pale green iced drink, ice pieces, flat lid, dark green straw inserted between slightly parted lips as if sipping. Left hand holds the cup near shoulder height close to camera so it appears large in foreground, fingers wrapped around cup, nails clearly visible. Outdoor low-angle selfie, subject filling most of the frame, head upright with slight forward tilt, neutral slightly unimpressed expression, deadpan selfie vibe. Outside under a leafy tree, tree trunk on left edge, dense green leaves overhead, bright blue sky behind. Natural daylight with mild backlight, sun filtered by leaves creating rim light around hairline and subtle glow on cup lid, dappled leaf light in background. iPhone selfie camera, 1x wide 26mm equivalent, slightly low angle pointing upward emphasizing sky and leaves. Vertical 9:16 tight portrait, face centered, cup dominates left-lower quadrant. Sharp focus on lips straw sunglasses stickers and nails, background leaves slightly softer. Photorealistic.",
    "aspect_ratio": "9:16"
  },
  "wait": true
}
```

## Inputs

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `model` | string | yes | — | `phota` or a route key below | Which model runs the job. |
| `prompt` | string | no | — | — | — |
| `files` | array of { url } | no | — | — | — |
| `aspect_ratio` | string | no | — | e.g. 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9 \| auto | — |

Media inputs are URLs. Upload a local file first with `POST /v2/files` and pass the returned URL.

## Provider options

Optional, per provider, under `provider_options.<provider>`. Only the options of the provider that runs the job apply — pin a route to choose it.

### provider_options.fal

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `prompt` | string | no | — | — | 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. |
| `sync_mode` | boolean | no | — | — | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. |
| `num_images` | integer | no | — | 1–4 | Number of images to generate. |
| `resolution` | string | no | — | 1K \| 4K | — |
| `aspect_ratio` | string | no | — | auto \| 1:1 \| 16:9 \| 4:3 \| 3:4 \| 9:16 | — |
| `output_format` | string | no | — | jpeg \| png | — |

## Routes

`"model": "phota"` picks a route automatically (priority order, then the inputs you send). To pin one, pass its key as `model`.

| model key | provider | modality | price from | typical time |
|---|---|---|---|---|
| `fal:phota` | fal | text-to-image | $0.09 | ~15 s |

## Example output

- image/jpeg: https://s3.varg.ai/o/job_e0f9dca0.jpg

---

Catalog version 2026-11-11T12:59:09.901887+00:00. All models: https://varg.ai/models/llms.txt