ChatBot 智能体(socket)

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer {{api_key}}

Body 参数application/json

agent_name

enum<string>

调用智能体名称

必需

枚举值:

chat_bot_v2

默认值:

chat_bot_v2

示例值:

chat_bot_v2

upload_format

enum<string>

语音识别格式

可选

枚举值:

pcmwavopusspeexaacamr

默认值:

pcm

示例值:

pcm

upload_sample_rate

enum<integer>

语音识别采样率

可选

枚举值:

800016000

默认值:

16000

mode

enum<string>

必需

1.

选择智能体模式，自动选择好llm, tts,和asr参数。

2.

standard为标准模式，成本较低，采用高性价比的语音识别和语音合成模型，音色效果良好。

3.

pro为专家模式，成本高，可识别中文方言，语音合成更加拟人。

4.

customize为自定义模式，用户自己选择llm, tts和asr模型。

5.

只有在customize模式下，llm_model, tts_model,asr_model, max_token参数才可以自己设置。

枚举值:

standardprocustomize

默认值:

customize

emotion_output

boolean

是否启动识别情绪

可选

voice_id

enum<string>

必需

机器人的语音音色。MiniMax和腾讯语音合成对应的音色请参考TTS 音色列表示例值：female-tianmei 默认值：female-tianmei

枚举值:

male-qn-qingsemale-qn-jingyingmale-qn-badaomale-qn-daxueshengfemale-shaonvfemale-yujiefemale-chengshufemale-tianmeipresenter_malepresenter_femaleaudiobook_male_1audiobook_male_2audiobook_female_1audiobook_female_2male-qn-qingse-jingpinmale-qn-jingying-jingpinmale-qn-badao-jingpinmale-qn-daxuesheng-jingpinfemale-shaonv-jingpinfemale-yujie-jingpinfemale-chengshu-jingpinfemale-tianmei-jingpinclever_boycute_boylovely_girlpeppa_pigbingjiao_didijunlang_nanyouchunzhen_xuedilengdan_xiongzhangbadao_shaoyetianxin_xiaolingqiaopi_mengmeiwumei_yujiediadia_xuemeidanya_xuejieSanta_ClausGrinchRudolphArnoldCharming_SantaCharming_LadySweet_GirlCute_ElfAttractive_GirlSerene_Woman

示例值:

cute_boy

speed

number

可选

TTS 语音合成语速控制

默认值:

0

示例值:

0

user_name

string

必需

(新)参数用户名称

默认值:

user_name

示例值:

小明

user_age

integer

用户年龄设置

可选

默认值:

5

示例值:

5

bot_name

string

机器人姓名设置

可选

默认值:

智酱

示例值:

智酱

bot_character_description

string

可选

(新)参数机器人角色设置

示例值:

智酱是一个彩色史莱姆生物。这是一个搞笑的魔法生物，充满活力，喜欢探索新事物，喜欢帮助小朋友学习。

bot_personality

string

可选

(新)调整参数机器人性格设置

默认值:

活泼,好奇,乐观,善良

示例值:

活泼,好奇,乐观,善良

bot_tone

string

可选

(新)参数机器人回复风格设定

示例值:

用拟人和口语化的方式回答用户，说话习惯附带emoji表情。

llm_model

enum<string>

LLM 大语言模型

可选

枚举值:

qwen-plus-latestqwen-max-latestqwen-turbo-latestqwen2.5-14b-instruct-1mqwen-math-plus-latestqwen-coder-plus-latestqwen2.5-vl-32b-instructqwen2.5-vl-72b-instructqwen-vl-max-latestqwen-vl-plus-latestqvq-maxqwq-32bqwq-plusGLM-4-PlusGLM-4-AirGLM-4-FlashGLM-Z1-AirGLM-Z1-AirXGLM-Z1-FlashGLM-4-LongGLM-4V-PlusGLM-4V-Flashdoubao-1-5-thinking-pro-250415Doubao-1.5-pro-32kDoubao-1.5-pro-256kDoubao-1.5-lite-32kdoubao-1.5-vision-pro-250328doubao-1.5-vision-lite-250315Doubao-pro-32k-characterdeepseek-chatdeepseek-reasonerdeepseek-v3-freedeepseek-r1-freedeepseek-v3-aliyundeepseek-r1-aliyundeepseek-v3-baiduyundeepseek-r1-baiduyundeepseek-v3-tencentdeepseek-r1-tencentdeepseek-v3-volcenginedeepseek-r1-volcenginedeepseek-v3-siliconflowdeepseek-r1-siliconflowdeepseek-r1-minimaxMiniMax-Text-01abab7-chat-previewabab6.5s-chathunyuan-litehunyuan-turbos-latesthunyuan-t1-latesthunyuan-large-longcontexthunyuan-visionernie-4.5-turbo-32kernie-x1-turbo-32kernie-4.5-turbo-vl-32kernie-speed-128kyi-largeyi-lightningyi-medium-200kyi-visionBaichuan4-TurboBaichuan4-AirBaichuan3-Turbo-128kLiteMax-32K4.0Ultrakimi-latestgpt-4o-minigpt-4.1gpt-4.1-minigpt-4.1-nanogpt-4ogpt-4o-freegpt-4o-imagegpt-4.5-previewo3-minio1Claude-3.5-Sonnetclaude-3.7-sonnetclaude-3.7-sonnet-thinkingclaude-3.7-sonnet-freeclaude-3.7-sonnet-thinking-freegemini-2.5-flash-preview-04-17gemini-2.5-pro-preview-05-06gemini-2.0-flash-preview-image-generationgemini-2.0-flash-001gemini-2.0-flash-litegrok-3grok-3-reasoninggrok-3-deepsearchgrok-3-search

默认值:

abab6.5s-chat

示例值:

abab6.5s-chat

max_tokens

integer

可选

LLM 大语言模型调用时的max_tokens

>= 20<= 8000

默认值:

50

示例值:

30

tts_model

enum<string>

可选

TTS 语音合成模型

枚举值:

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>

可选

(新)参数语种设定

枚举值:

中文English

默认值:

中文

示例值:

中文

示例

{
  "agent_name": "chat_bot_v2",
  "upload_format": "pcm",
  "upload_sample_rate": 16000,
  "mode": "pro",
  "emotion_output": true,
  "voice_id": "cute_boy",
  "speed": 0,
  "user_name": "小明",
  "user_age": 5,
  "bot_name": "智酱",
  "bot_character_description": "智酱是一个彩色史莱姆生物。这是一个搞笑的魔法生物，充满活力，喜欢探索新事物，喜欢帮助小朋友学习。",
  "bot_personality": "活泼,好奇,乐观,善良",
  "bot_tone": "用拟人和口语化的方式回答用户，说话习惯附带emoji表情。",
  "llm_model": "abab6.5s-chat",
  "max_tokens": 30,
  "tts_model": "MM_TTSL_realtime_speech-01-turbo",
  "session_token": "0886a1f1-cd25-445a-9f3a-767032da9b84",
  "language": "中文"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.mindcraft.com.cn' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agent_name": "chat_bot_v2",
    "upload_format": "pcm",
    "upload_sample_rate": 16000,
    "mode": "pro",
    "emotion_output": true,
    "voice_id": "cute_boy",
    "speed": 0,
    "user_name": "小明",
    "user_age": 5,
    "bot_name": "智酱",
    "bot_character_description": "智酱是一个彩色史莱姆生物。这是一个搞笑的魔法生物，充满活力，喜欢探索新事物，喜欢帮助小朋友学习。",
    "bot_personality": "活泼,好奇,乐观,善良",
    "bot_tone": "用拟人和口语化的方式回答用户，说话习惯附带emoji表情。",
    "llm_model": "abab6.5s-chat",
    "max_tokens": 30,
    "tts_model": "MM_TTSL_realtime_speech-01-turbo",
    "session_token": "0886a1f1-cd25-445a-9f3a-767032da9b84",
    "language": "中文"
}'

返回响应

🟢200对话聊天数据

text/plain

Body

object {0}

示例

{"socket_type": "response_event", "socket_status": 1005, "socket_message": "stop_stream_successfully"}

{"socket_type": "agent_response", "agent_output": {"asr_content": "好好，你是谁？你", "llm_response": "我是智酱", "tts_audio": "", "emotion_value": "其他"}}

{"socket_type": "agent_response", "agent_output": {"asr_content": "好好，你是谁？你", "llm_response": "，住在芯片王国", "tts_audio": "http://192.168.1.192/v1/data/stream_tts/0ea59425057a4666b369516e15b059dd/", "emotion_value": "其他"}}

{"socket_type": "response_event", "socket_status": 1006, "socket_message": "agent_stop"}

ChatBot 智能体(socket)

链接socket + 认证

智能体 chat_bot_v2

示例JS文件下载

请求参数

示例代码

返回响应

ChatBot 智能体(socket)

链接socket + 认证#

智能体 chat_bot_v2#

示例JS文件下载#

请求参数

示例代码

返回响应

链接socket + 认证

智能体 chat_bot_v2

示例JS文件下载