# Soul 2 API

> Higgsfield's Soul 2: fashion-grade, true-to-life photos of people from a prompt, at 720p or 1080p, in seven shapes from 9:16 to 16:9. By Higgsfield, on Revana from $0.01 per image.

- Model id: `soul-2`
- Kind: image
- Maker: Higgsfield
- Tasks: Text to image
- Resolutions: 720p, 1080p
- Routes: 1
- Status: live on the API
- Page: https://revana.si/models/soul-2

## Price (per image, USD)

| Setting | Price | Credits |
|---|---|---|
| 720p | $0.01 | 1 |
| 1080p | $0.01 | 1 |

100 credits = $1. Charged once, only for the route that succeeds; failed generations cost nothing.

## Request

POST https://api.revana.si/v1/generations with `Authorization: Bearer $REVANA_API_KEY` and an `Idempotency-Key` header: one key per request, made once and sent again on every resend after a timeout, a 429 or a 5xx, so the request is never made or charged twice. After a generation has failed, use a new key.

```json
{
  "model": "soul-2",
  "input": {
    "prompt": "A product photo of a ceramic coffee cup on a linen tablecloth, soft morning light",
    "resolution": "720p"
  },
  "max_cost_usd": 0.02
}
```

`max_cost_usd` is your cap, the most this request may cost (it lists at $0.01). Poll `GET /v1/generations/{id}` until `status` is `succeeded` or `failed`, then download `GET /v1/generations/{id}/content`. Full API: https://revana.si/llms.txt

## Similar models

- [Genjutsu Motion Transfer](https://revana.si/models/genjutsu-motion-transfer.md): from $0.21 per second of video
- [Genjutsu Object Swap](https://revana.si/models/genjutsu-object-swap.md): from $0.21 per second of video
- [Marketing Studio Image](https://revana.si/models/marketing-studio-image.md): from $0.04 per image
- [Soul](https://revana.si/models/soul.md): from $0.13 per image
- [Soul Cinema](https://revana.si/models/soul-cinema.md): from $0.01 per image
- [Nano Banana Pro](https://revana.si/models/nano-banana-pro.md): from $0.04 per image