MindCraft AI
  1. 聊天机器人V3 AI角色(socket)
MindCraft AI
  • 在线调用-使用说明
  • 基础模型
    • 大语言模型 LLM
      • 其他平台上使用API
        • DIFY上使用API
        • ONE-API 上使用API
        • FastGPT 上使用API
        • 沉浸式翻译(浏览器插件) 上使用API
        • Cursor上使用MindCraft API
        • Cherry Studio上使用MindCraft API
      • LLM 模型列表+参数
      • LLM 模型对话调用
    • 语音识别 ASR
      • 语音识别请求
        • 腾讯 一句话识别
        • 腾讯 文件识别(进task任务)
        • 腾讯大模型 文件识别(进task任务)
        • 阿里 paraformer
        • 阿里 sensevoice(进task任务)
        • 字节跳动 一句话识别
      • 语音识别请求(汇总)
      • 模型列表及参数获取
      • 任务(task)数据获取
    • 语音合成 TTS
      • TTS 音色列表
      • 语音合成请求
        • 字节跳动 通用合成
        • MiniMax 短文本 V2
        • MiniMax 长文本
        • 腾讯 通用合成-普通音色
        • 腾讯 通用合成-精品音色
        • 腾讯 长文本合成-普通音色
        • 腾讯 长文本合成-精品音色
        • 科大讯飞 通用合成
        • 阿里云 语音合成CosyVoice
        • 百度 短文本合成
      • 语音合成请求(汇总)
      • 模型列表及参数获取
      • 任务(task)数据获取
    • 图片生成 Images Generations
      • 图片生成请求
        • Flux.1 文生图
        • 智谱 文生图
        • 欧朋ai 文生图
        • 通义万象 文生图
        • 豆包 文生图
        • DeepSeek 文生图
        • MiniMax 文生图
        • Gemini 文生图 Copy
      • 图片生成请求(汇总)
      • 模型列表及参数获取
    • 视频合成 Video Generations
      • 视频合成请求
        • 智谱 文生视频
        • 智谱 图片生视频
        • MiniMax 文生视频
        • MiniMax 图生视频
        • 腾讯 文生视频
        • 通义万象 文生视频
        • 通义万象 图生视频
        • 豆包 文生视频
        • 豆包 图生视频
      • 视频合成请求(汇总)
      • 模型列表及参数获取
      • 任务(task)数据获取
    • RAG模型
      • embedding 多模态向量模型
      • embedding 文字向量模型
      • rerank 文字向量模型
    • 音色处理 voice processing
      • 音色克隆
        • 声音克隆流程
        • 上传音频
        • 生成试听
        • 保存克隆
    • 图生图 Image to Image
      • make局部编辑
        • 提取 mask
        • 消除 mask
        • 重绘 mask
        • 扩图 mask
      • 图生图
        • i2i 图片一致性
        • i2i 指令编辑模型
        • i2i 超分辨率模型
        • i2i 风格化模型
  • 智能体
    • 聊天机器人V3 AI角色(socket)
      • 角色资源加载规则
      • 角色人设加载
        • AI角色UUIDS数据
        • 用户人设UUIDS数据
      • ChatBot 智能体V3(socket)
        POST
    • AI桌面助手 V1 AI角色
      • AI桌面助手V1(Socket)
    • socket Device认证
      • device 获取token
  • 对话数据
    • session 对话
      • message 聊天数据
        • message 获取列表
        • message 创建消息
        • message 修改消息
        • message 删除数据
        • message 清空记录
      • session 获取对话列表
      • session 创建新对话
      • session 更改对话
      • session 删除对话
  1. 聊天机器人V3 AI角色(socket)

ChatBot 智能体V3(socket)

开发中
POST
https://api.mindcraft.com.cn

流程图示意#

流程示意图

链接socket + 认证#

建立websocket链接
ApiKey认证
DeviceToken认证

智能体 chat_bot_v3#

初始创建
停止语音上传
终止流体返回数据

socket 返回示例说明#

情感输出示例
{
    "socket_type": "agent_event",
    "socket_message": "request_completed",
    "socket_status": 1003,
    "event_name": "agent_action",
    "agent_output": {
        "output_type": "emotion",
        "emotion_output": "happy"
    },
    "agent_name": "chat_bot_v3"
}
此示例表明代理chat_bot_v3完成了一次请求,事件为agent_action,输出类型为情感,识别到的情感为“happy”。
LLM输出示例
TTS输出示例
智能体停止示例
提示

示例调用+下载#

在线调用示例demo#

github项目#

gitee项目#

请求参数

Header 参数
Authorization
string 
必需
示例值:
Bearer {{api_key}}
Body 参数application/json
agent_name
enum<string> 
调用智能体名称
必需
枚举值:
chat_bot_v3
默认值:
chat_bot_v3
示例值:
chat_bot_v3
mode
enum<string> 
必需
1.
选择智能体模式,自动选择好llm, tts,和asr参数。
2.
pro为专家模式,默认选择此模式,效果更好支持AI角色和用户设定ID导入。
3.
customize为自定义模式,用户自己选择llm, tts和asr模型。
4.
只有在customize模式下,llm_model, tts_model,asr_model, max_token参数才可以自己设置。
枚举值:
procustomize
默认值:
pro
character_uuid
string 
可选
AI角色ID,详细在智匠角色广场里查看
示例值:
mc20250326a54kf
profile_uuid
string 
可选
用户人设ID,详细在智匠角色广场里查看
示例值:
mc20250327a58srl
emotion_output
boolean 
是否启动识别情绪
可选
upload_format
enum<string> 
语音识别格式
可选
枚举值:
pcmwavopusspeexaacamr
默认值:
pcm
示例值:
pcm
upload_sample_rate
enum<integer> 
语音识别采样率
可选
枚举值:
800016000
默认值:
16000
voice_id
string 
必需
pro模式下选择MiniMax音色,standard模式下选择腾讯音色,customize模式下根据选择的tts_model选择音色。
若是调用character_uuid则此字段无效,自动选择character_uuid中的音色
机器人的语音音色。对应的音色请参考TTS 音色列表 示例值:female-tianmei 默认值:female-tianmei
示例值:
cute_boy
speed
number 
可选
TTS 语音合成语速控制
默认值:
0
示例值:
0
user_name
string 
可选
机器人对话用户名称,仅在未输入profile_uuid时有效,profile_uuid优先级更高
默认值:
user_name
示例值:
小明
user_age
integer 
用户年龄设置
可选
默认值:
5
示例值:
5
bot_name
string 
可选
机器人姓名设置,仅在未输入character_uuid时有效,character_uuid优先级更高
默认值:
智酱
示例值:
智酱
bot_character_description
string 
可选
机器人角色设置,仅在未输入character_uuid时有效,character_uuid优先级更高
示例值:
智酱是一个彩色史莱姆生物。这是一个搞笑的魔法生物,充满活力,喜欢探索新事物,喜欢帮助小朋友学习。
bot_personality
string 
可选
机器人性格设置,仅在未输入character_uuid时有效,character_uuid优先级更高
默认值:
活泼,好奇,乐观,善良
示例值:
活泼,好奇,乐观,善良
bot_tone
string 
可选
机器人回复风格设定,仅在未输入character_uuid时有效,character_uuid优先级更高
示例值:
用拟人和口语化的方式回答用户,说话习惯附带emoji表情。
llm_model
enum<string> 
LLM 大语言模型
可选
枚举值:
GLM-4-AirDoubao-1.5-lite-32kabab6.5s-chat
默认值:
abab6.5s-chat
示例值:
abab6.5s-chat
max_tokens
integer 
可选
LLM 大语言模型 调用时的max_tokens,standard/pro模式最大为100,customize模式下可随意修改
>= 20<= 8000
默认值:
100
示例值:
100
tts_model
enum<string> 
可选
TTS 语音合成模型,pro模式下默认为MM_TTSL_realtime_speech-01-turbo,standard模式下TX_TTSP_realtime
枚举值:
TX_TTSP_realtimeTX_TTSL_realtimeMM_TTSL_realtime_speech-01-turboZJ_TTSL_realtimeALI_TTSL_realtime_cosyvoice-v1XF_TTS_realtimeBD_TTS_realtime_zh
默认值:
TX_TTSP_realtime
示例值:
MM_TTSL_realtime_speech-01-turbo
session_token
string 
可选
使用session 记录聊天记录,下方接口获取session_token
session 获取对话列表
session 创建新对话
示例值:
0886a1f1-cd25-445a-9f3a-767032da9b84
language
enum<string> 
可选
(新)参数 语种设定
枚举值:
autozhenjayueko
默认值:
auto
示例值:
auto
示例
{
    "agent_name": "chat_bot_v3",
    "mode": "customize",
    "profile_uuid": "mc20250327a58srl", 
    "character_uuid": "mc20250326a54kf",
    "tts_model": "MM_TTSL_realtime_speech-01-turbo",
    "speed": 0,
    "max_tokens": 100,
    "emotion_output": true,
    "session_token": "0886a1f1-cd25-445a-9f3a-767032da9b84",
    "upload_format": "pcm",
    "upload_sample_rate": 16000,
    "language": "auto"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mindcraft.com.cn' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agent_name": "chat_bot_v3",
    "mode": "customize",
    "profile_uuid": "mc20250327a58srl", 
    "character_uuid": "mc20250326a54kf",
    "tts_model": "MM_TTSL_realtime_speech-01-turbo",
    "speed": 0,
    "max_tokens": 100,
    "emotion_output": true,
    "session_token": "0886a1f1-cd25-445a-9f3a-767032da9b84",
    "upload_format": "pcm",
    "upload_sample_rate": 16000,
    "language": "auto"
}'

返回响应

🟢200对话聊天数据
text/plain
Body
object {0}
示例
{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "emotion", "emotion_output": "happy"}, "agent_name": "chat_bot_v3"}

{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "llm", "asr_content": "你好啊", "llm_response": "林小宅你好呀!", "z_index": 0}, "agent_name": "chat_bot_v3"}

{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "llm", "asr_content": "你好啊", "llm_response": "(*^▽^*) 今天过得怎么样呢?", "z_index": 1}, "agent_name": "chat_bot_v3"}

{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "llm", "asr_content": "你好啊", "llm_response": "我刚刚发现了一部超好看的热血动漫,想不想知道是哪一部?", "z_index": 2}, "agent_name": "chat_bot_v3"}

{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "tts", "audio_seconds": 1.26, "tts_audio": "https://api.mindcraft.com.cn/v1/data/get_stream_tts/4a312ef1f4b7422bb6e88ba034132c0c.mp3", "z_index": 0}, "agent_name": "chat_bot_v3"}

{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "tts", "audio_seconds": 2.13, "tts_audio": "https://api.mindcraft.com.cn/static/agent/4a312ef1f4b7422bb6e88ba034132c0c/2.mp3", "z_index": 1}, "agent_name": "chat_bot_v3"}

{"socket_type": "agent_event", "socket_message": "request_completed", "socket_status": 1003, "event_name": "agent_action", "agent_output": {"output_type": "tts", "audio_seconds": 4.47, "tts_audio": "https://api.mindcraft.com.cn/static/agent/4a312ef1f4b7422bb6e88ba034132c0c/3.mp3", "z_index": 2}, "agent_name": "chat_bot_v3"}

{"socket_type": "agent_event", "socket_message": "agent_stop", "socket_status": 1006, "event_name": "agent_action", "agent_name": "chat_bot_v3"}
上一页
用户人设UUIDS数据
下一页
AI桌面助手V1(Socket)
Built with