Characters & references
Describe the overall image in the main prompt and each character in a separate prompt.
Separate character prompts
{
"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
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.