# Characters & references

Describe the overall image in the main prompt and each character in a separate prompt.

## Separate character prompts

```json
{
  "prompt": "watercolor, a quiet garden, afternoon light",
  "auto_character_positions": true,
  "characters": [
    {
      "prompt": "adult painter, blue coat, holding a sketchbook",
      "negative_prompt": "blurry"
    },
    {
      "prompt": "adult gardener, straw hat, holding flowers",
      "negative_prompt": ""
    }
  ]
}
```

This example uses automatic character positioning. V4.5 supports up to 6 characters and V5 up to 32. Keep character descriptions separate from global style.

## Upload an image

```bash
curl --fail-with-body https://noveadream.com/v1/nai/assets \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -F "file=@reference.png"
```

Use the returned data.id. Assets belong to the uploading account; retain separate asset IDs for the source image, mask and references.

## Generation controls

| Field | Value |
| --- | --- |
| steps | 1–50 |
| count | 1–4 |
| seed | 0–4294967295 |
| guidance | 0–10 |
| source_strength | (0, 1] |
| source_noise | 0–1 |

Do not combine precise references and Vibe in the same request. Supported reference modes, transparency and enhancement differ by variant; check capabilities first.