更新角色实例属性
仅提交变更字段。
请求信息
请求 URI
PUT https://lg.jimitu.top/api/open/characters/{id}请求头参数
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API Key}，接口鉴权，所有请求均需携带 |
Content-Type | 否 | 仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json |
请求路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | integer | 是 | 角色实例 ID |
请求体参数
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 角色名称 |
| description | string | 描述 |
| avatar | string | 头像路径 |
| basic_personality | string | 基础人设 |
| personality | string | 性格 |
| background | string | 背景 |
| background_story | string | 背景故事 |
| greeting | string | 问候语 |
| gender | string | 性别 |
| age_stage | string | 年龄段 |
| catchphrase | string | 口头禅 |
| rag_enabled | boolean | 是否启用 RAG |
| memory_enabled | boolean | 是否启用记忆 |
| tts_enabled | boolean | 是否启用 TTS |
| tts_voice_id | string | TTS 音色 ID |
| tts_audio_codec | string | 音频编码：pcm / opus |
| recommendation_enabled | boolean | 是否启用推荐 |
| vision_enabled | boolean | 是否启用视觉 |
请求示例
curl -X PUT "https://lg.jimitu.top/api/open/characters/{id}" \
-H "Authorization: Bearer <your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"name": "小叽",
"greeting": "你好呀！"
}'响应信息
响应体示例
同 GET 详情（data: CharacterDetail）。
错误码
错误码
| error_code | 状态码 | 说明 |
|---|---|---|
CHARACTER_NOT_FOUND | 404 | 角色不存在 |