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

🔧请求信息

请求 URI

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

请求头参数

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

请求路径参数

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

请求示例

curl -X GET "https://lg.jimitu.top/api/open/characters/{id}" \
  -H "Authorization: Bearer <your_api_key>"

📥响应信息

响应体示例

{
  "success": true,
  "data": {
    "id": 555,
    "template_id": 10,
    "name": "小叽",
    "description": "...",
    "basic_personality": "...",
    "personality": "...",
    "gender": "female",
    "age_stage": "adult",
    "background": "...",
    "background_story": "...",
    "greeting": "你好呀!",
    "avatar": "/path/to/avatar.png",
    "catchphrase": "...",
    "rag_enabled": false,
    "memory_enabled": true,
    "tts_enabled": true,
    "tts_voice_id": "qwen-xxx",
    "tts_audio_codec": "pcm",
    "recommendation_enabled": false,
    "vision_enabled": false,
    "created_at": "...",
    "updated_at": "..."
  }
}

响应参数

字段类型说明
idinteger角色实例 ID
template_idinteger模版 ID
namestring角色名称
descriptionstring描述
basic_personalitystring基础人设
personalitystring性格
genderstring性别
age_stagestring年龄段:young / adult / old
backgroundstring背景
background_storystring背景故事
greetingstring问候语
avatarstring头像路径
catchphrasestring口头禅
rag_enabledboolean是否启用 RAG
memory_enabledboolean是否启用记忆
tts_enabledboolean是否启用 TTS
tts_voice_idstringTTS 音色 ID
tts_audio_codecstring音频编码:pcm / opus
recommendation_enabledboolean是否启用推荐
vision_enabledboolean是否启用视觉
created_atstring创建时间
updated_atstring更新时间
注意

avatar 为相对路径时,前端拼接 API_BASE_URL 前缀展示。

⚠️错误码

错误码

error_codeHTTP说明
CHARACTER_NOT_FOUND404角色不存在