MindCraft AI
  1. AI桌面助手 V1 AI角色
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)
    • AI桌面助手 V1 AI角色
      • AI桌面助手V1(Socket)
        POST
    • socket Device认证
      • device 获取token
  • 对话数据
    • session 对话
      • message 聊天数据
        • message 获取列表
        • message 创建消息
        • message 修改消息
        • message 删除数据
        • message 清空记录
      • session 获取对话列表
      • session 创建新对话
      • session 更改对话
      • session 删除对话
  1. AI桌面助手 V1 AI角色

AI桌面助手V1(Socket)

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

流程图示意#

流程图示意图

链接socket + 认证#

建立websocket链接
ApiKey认证
DeviceToken认证

智能体 desktop_assistant_v1#

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

socket 返回示例说明#

聊天场景
场景通知
聊天场景-情绪识别
聊天场景-音频数据
聊天场景-文字聊天
通用场景-结束对话
    {
        "socket_status": 1007,
        "socket_message": "agent_event",
        "socket_type": "agent_event",
        "event_name": "agent_action",
        "socket_data": {
            "agent_type": "text",
            "agent_name": "desktop_assistant_v1"
        }
    }
此次事件为 agent_action ,没有 agent_output 表示场景通知,输出类型为 text,表示接下来会进行文本对话交流。
询问天气
闹钟数据
倒计时
系统设置

请求参数

Header 参数
Authorization
string 
必需
示例值:
Bearer {{api_key}}
Body 参数application/json
agent_name
enum<string> 
调用智能体名称
必需
枚举值:
desktop_assistant_v1
默认值:
desktop_assistant_v1
示例值:
desktop_assistant_v1
map_name
enum<string> 
可选
场景位置 不传默认场景
枚举值:
textcheck_weatherset_alarmset_countdownmodify_device_config
session_token
string 
必需
使用session 记录聊天记录,下方接口获取session_token
session 获取对话列表
session 创建新对话
示例值:
cebc7012-6d12-44b2-84c3-60bd7de5001d
upload_format
enum<string> 
语音识别格式
可选
枚举值:
pcmwavopusspeexaacamr
默认值:
pcm
示例值:
pcm
upload_sample_rate
enum<integer> 
语音识别采样率
可选
枚举值:
800016000
默认值:
16000
language
enum<string> 
设置语种
可选
枚举值:
autozhenjayueko
默认值:
中文
示例值:
english中文
character_uuid
string 
角色uuid
可选
profile_data
object 
角色数据
可选
profile_uuid
string 
档案uuid
可选
emotion_output
boolean 
情绪识别
可选
示例
{
    "agent_name": "desktop_assistant_v1",
    "map_name": "modify_device_config",
    "session_token": "cebc7012-6d12-44b2-84c3-60bd7de5001d",
    "upload_format": "pcm",
    "upload_sample_rate": 16000,
    "language": "zh",
    "character_uuid": "mc20250326a54kf",
    "emotion_output": true,
    "profile_data": {"name":"小明","age":16,"gender":"未指定","profession":"学生","hobbies":["看书"]},
    "profile_uuid": "mc20250327a58srl"
}

示例代码

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": "desktop_assistant_v1",
    "map_name": "modify_device_config",
    "session_token": "cebc7012-6d12-44b2-84c3-60bd7de5001d",
    "upload_format": "pcm",
    "upload_sample_rate": 16000,
    "language": "zh",
    "character_uuid": "mc20250326a54kf",
    "emotion_output": true,
    "profile_data": {"name":"小明","age":16,"gender":"未指定","profession":"学生","hobbies":["看书"]},
    "profile_uuid": "mc20250327a58srl"
}'

返回响应

🟢200对话数据
text/plain
Body
object {0}
示例
{"socket_status": 1007, "socket_message": "agent_event", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_type": "text", "agent_name": "desktop_assistant_v1"}}

{"socket_status": 1007, "socket_message": "agent_event", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_type": "text", "agent_output": {"user_input": "你好啊", "llm_response": "", "tts_audio": "http://192.168.1.10/v1/data/redis_stream_tts/c029db0b180d4791ab69c61f9ece036a.mp3", "emotion_output": "happy"}, "agent_name": "desktop_assistant_v1"}}

{"socket_status": 1007, "socket_message": "agent_event", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_type": "text", "agent_output": {"user_input": "你好啊", "llm_response": "哈喽哈喽😎 小明同学,今天找我有啥好玩的事儿呀🧐 是想跟我分享趣事,还是有啥问题要我帮忙解答呀🤗 不管啥事儿,咱都能唠得超开心😜", "tts_audio": "http://192.168.1.10/v1/data/redis_stream_tts/c029db0b180d4791ab69c61f9ece036a.mp3", "emotion_output": "happy"}, "agent_name": "desktop_assistant_v1"}}

...


{"socket_status": 1006, "socket_message": "agent_stop", "socket_type": "agent_event", "event_name": "agent_action", "socket_data": {"agent_name": "desktop_assistant_v1"}}
🟢200获取天气
🟢200闹钟数据
🟢200倒计时
🟢200系统设置
上一页
ChatBot 智能体V3(socket)
下一页
device 获取token
Built with