> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Soul 2

> Photoreal text to image with Higgsfield Soul 2: film look, skin and light. Runs on a workspace Higgsfield key.

Model id `higgsfield-soul-2` · Higgsfield · image · 1 mode: `text-to-image`.

> [!NOTE]
>
> This page reflects the current catalog. Inputs, allowed values, limits and prices can change as the model evolves; the field names and their meaning do not. For the exact schema at any time, your agent calls [`get_model`](https://docs.argil.ai/v2/mcp/tools) with the mode.

## Text To Image

Mode `text-to-image`. Text to image.

### Input

| Field | Type | Required | Allowed | Default | Description |
| - | - | - | - | - | - |
| `prompt` | string | Yes | | | What the image should show. |
| `aspect_ratio` | string | | `9:16`, `16:9`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2` | `1:1` | Width-to-height ratio of the generated images. |
| `resolution` | string | | `720p`, `1080p` | `720p` | Output resolution. 1080p costs more per image. |
| `enhance_prompt` | boolean | | | | Rewrite the prompt with the model before generating. |
| `seed` | integer | | 1 to 1000000 | | Seed for reproducible results. |
| `num_images` | integer | | `1`, `4` | | How many images to generate: 1 or 4. |
| `style` | string | | `Y2K studio`, `Street photography`, `Editorial street style`, `Warm ambient`, `Drain`, `Neutral pastel film`, `Digital camera`, `Old smartphone`, `General`, `Asian nostalgia`, `Flash editorial`, `Frutiger aero`, `Muted cool film`, `Double exposure`, `Disposable camera`, `Surreal solarization`, `Underwater`, `Siren`, `Candy pop`, `Mystique city`, `Subtle flash`, `80s horror`, `New Indie`, `Extraterrestrial`, `Theatrical light`, `Y2K street`, `Warm contrast film`, `Retro BW`, `Swag era`, `Nature light`, `2000s band`, `Warm vivid film`, `BW film` | | A preset look. Unset uses General. |

### Pricing

0.15 credits/image at 720p, 0.28 at 1080p.

Fixed price: charged as estimated.

For the exact price of a request, use [`estimate_generation`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "model": "higgsfield-soul-2",
  "mode": "text-to-image",
  "input": {
    "prompt": "Studio photo of a ceramic mug with steam, soft morning light",
    "aspect_ratio": "1:1",
    "resolution": "720p"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.