# 角色、参考与精细控制

主提示词描述整体画面，角色提示词分别控制人物。

## 独立角色提示词

```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": ""
    }
  ]
}
```

示例使用自动角色位置。V4.5 最多 6 个角色，V5 最多 32 个；角色描述与全局画风分开填写。

## 上传图片

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

后续请求使用返回的 data.id，素材属于上传账号。原图、遮罩与参考图应分别保存对应的资产 ID。

## 绘图参数

| 字段 | 取值 |
| --- | --- |
| steps | 1–50 |
| count | 1–4 |
| seed | 0–4294967295 |
| guidance | 0–10 |
| source_strength | (0, 1] |
| source_noise | 0–1 |

精确参考与 Vibe 不在同一请求内混用。各版本支持的参考方式、透明背景和增强能力不同，提交前查询 capabilities。