服务端 API 接口文档
文档中心/LG 开放平台/更新角色实例属性
更新角色实例属性
更新时间:2026/08/18

仅提交变更字段。

🔧请求信息

请求 URI

PUT https://lg.jimitu.top/api/open/characters/{id}

请求头参数

Header必填说明
AuthorizationBearer {API Key},接口鉴权,所有请求均需携带
Content-Type仅 POST/PUT 携带 JSON 请求体时需要,值为 application/json

请求路径参数

参数类型必填说明
idinteger角色实例 ID

请求体参数

字段类型说明
namestring角色名称
descriptionstring描述
avatarstring头像路径
basic_personalitystring基础人设
personalitystring性格
backgroundstring背景
background_storystring背景故事
greetingstring问候语
genderstring性别
age_stagestring年龄段
catchphrasestring口头禅
rag_enabledboolean是否启用 RAG
memory_enabledboolean是否启用记忆
tts_enabledboolean是否启用 TTS
tts_voice_idstringTTS 音色 ID
tts_audio_codecstring音频编码:pcm / opus
recommendation_enabledboolean是否启用推荐
vision_enabledboolean是否启用视觉

请求示例

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_codeHTTP说明
CHARACTER_NOT_FOUND404角色不存在