获取角色实例详情

请求信息

请求 URI

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

请求头参数

请求头	必填	说明
Authorization	是	Bearer {API Key}，接口鉴权，所有请求均需携带
Content-Type	否	仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json

请求路径参数

参数	类型	必填	说明
id	integer	是	角色实例 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": "..."
  }
}

响应参数

字段	类型	说明
id	integer	角色实例 ID
template_id	integer	模版 ID
name	string	角色名称
description	string	描述
basic_personality	string	基础人设
personality	string	性格
gender	string	性别
age_stage	string	年龄段：young / adult / old
background	string	背景
background_story	string	背景故事
greeting	string	问候语
avatar	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	是否启用视觉
created_at	string	创建时间
updated_at	string	更新时间

注意

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

错误码

错误码

error_code	状态码	说明
CHARACTER_NOT_FOUND	404	角色不存在