API 文档#
WebSocket 端点#
1. 音频对话（文本 LLM）#
端点：
/api/v4/audio_chat_with_text_llm描述：使用文本模态 LLM 进行对话处理的音频流式对话
请求模型：
AudioChatCompleteStartRequestV4
2. 音频对话（音频 LLM）#
端点：
/api/v4/audio_chat_with_audio_llm描述：使用音频模态 LLM 进行对话处理的音频流式对话
请求模型：
AudioChatExpressStartRequestV4
3. 文本对话（文本 LLM）#
端点：
/api/v4/text_chat_with_text_llm描述：使用文本模态 LLM 进行对话处理的文本对话
请求模型：
TextChatCompleteRequestV4
4. 文本对话（音频 LLM）#
端点：
/api/v4/text_chat_with_audio_llm描述：使用音频模态 LLM 进行对话处理的文本对话
请求模型：
TextChatExpressRequestV4
5. 直接动画生成#
端点：
/api/v4/text_generate描述：从文本直接生成动画，不经过对话
请求模型：
DirectGenerationRequest
HTTP 端点#
1. 健康检查#
端点：
GET /health或GET /api/v4/health描述：检查服务健康状态
响应：
{"status": "healthy"}
2. 日志#
查看日志
端点：
GET /tail_log/{n_lines}或GET /api/v4/tail_log/{n_lines}描述：获取日志文件的最后 N 行
参数：
n_lines——要获取的行数响应：HTML 格式日志内容
下载日志
端点：
GET /download_log_file描述：下载完整日志文件
响应：二进制日志文件
3. 适配器选择#
ASR 适配器
端点：
GET /api/v4/asr_adapter_choices描述：获取可用 ASR（语音识别）适配器列表
响应：
AdapterChoicesResponse
TTS 适配器
端点：
GET /api/v4/tts_adapter_choices描述：获取可用 TTS（语音合成）适配器列表
响应：
AdapterChoicesResponse
对话适配器
端点：
GET /api/v4/conversation_adapter_choices描述：获取可用 LLM 适配器列表
响应：
AdapterChoicesResponse
反应适配器
端点：
GET /api/v4/reaction_adapter_choices描述：获取可用 Reaction 适配器列表
响应：
AdapterChoicesResponse
分类适配器
端点：
GET /api/v4/classification_adapter_choices描述：获取可用 Classification 适配器列表
响应：
AdapterChoicesResponse
记忆适配器
端点：
GET /api/v4/memory_adapter_choices描述：获取可用 Memory 适配器列表
响应：
AdapterChoicesResponse
4. 音色与设置#
音色管理
端点：
GET /api/v4/tts_voice_names/{tts_adapter_key}描述：获取指定 TTS 适配器的可用音色列表
参数：
tts_adapter_key——TTS 适配器标识响应：
VoiceNamesResponse
用户音色设置
端点：
GET /api/v4/get_voice_settings/{user_id}/{character_id}描述：获取指定用户与角色的音色设置
参数：
user_id——用户 IDcharacter_id——角色 ID
响应：
VoiceSettingsResponse
动作设置
端点：
GET /api/v4/get_motion_settings/{user_id}/{character_id}描述：获取指定用户与角色的动作设置
参数：
user_id——用户 IDcharacter_id——角色 ID
响应：
MotionSettingsResponse