chat_bot_v1(自定义customize)

请求参数

Header 参数

Authorization

string

认证信息

必需

示例值:

Bearer {{api_key}}

Body 参数multipart/form-data

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

示例值:

customize

audio_file

file

必需

1.

上传需语音识别的音频文件。默认为wav格式。

2.

适用于web应用，直接传文件即可。在嵌入式开发中，若硬件上有足够内存缓存音频文件，也可以直接上传文件。

3.

asr_uuid和audio_file二选一。

示例值:

file://C:\Users\lery\Downloads\你好，很高兴认识你.wav

asr_uuid

string

必需

1.

将音频文件切片上传，对应的uuid具体获取参考xxx链接。

2.

在嵌入式开发中，当音频文件从SD卡中上传时使用，对于嵌入式开发可节省内存空间，并提高文件上传速度。

3.

asr_uuid和audio_file二选一。

示例值:

sAsr-291f0def3dbc4c77b918f360ae027452

upload_format

enum<string>

可选

ASR 语音识别的音频格式。示例值：wav

枚举值:

wavpcmogg-opusspeexsilkmp3m4aaacamr

默认值:

wav

示例值:

wav

emotion_output

boolean

是否启动识别情绪

可选

默认值:

false

示例值:

true

voice_id

string

必需

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

示例值:

10510000

output_format

enum<string>

可选

TTS 语音合成返回格式

枚举值:

mp3wavpcmflacaac

默认值:

mp3

示例值:

mp3

speed

number

可选

TTS 语音合成语速控制

>= 0.5<= 2

默认值:

1

示例值:

1

stream

boolean

流体内容回复

可选

示例值:

true

user_age

string

用户年龄设置

可选

示例值:

5

bot_name

string

机器人姓名设置

可选

默认值:

智酱

示例值:

智酱

bot_description

string

机器人角色介绍

可选

示例值:

你是住在芯片王国里的AI机器人，可以帮助用户解决各式各样的问题

bot_character

string

机器人角色设置

可选

默认值:

朋友

示例值:

朋友

bot_personality

string

机器人性格设置

可选

默认值:

有趣

示例值:

有趣

bot_response_style

enum<string>

机器人回复风格设定

可选

枚举值:

normalconversation

示例值:

normal

session_token

string

可选

使用session 记录聊天记录，下方接口获取session_token
session 获取对话列表
session 创建新对话

示例值:

e8eec3b3-c75f-4390-8a68-adf369c50fbe

llm_model

enum<string>

可选

(自定义参数)LLM 大语言模型

枚举值:

qwen-plus-latestqwen-max-latestqwen-turbo-latestqwen-math-plus-latestqwen-coder-plus-latestqwen-vl-max-latestqvq-72b-previewqwq-32b-previewqwen-vl-plus-latestqwen2.5-14b-instruct-1mqwen2.5-vl-72b-instructGLM-4-PlusGLM-4-AirGLM-4-FlashGLM-Zero-PreviewGLM-4-LongGLM-4V-PlusGLM-4V-FlashDoubao-1.5-pro-32kDoubao-1.5-pro-256kDoubao-1.5-lite-32kDoubao-1.5-vision-pro-32kDoubao-pro-32k-characterdeepseek-chatdeepseek-reasonerdeepseek-v3-aliyundeepseek-r1-aliyundeepseek-v3-baiduyundeepseek-r1-baiduyundeepseek-v3-tencentdeepseek-r1-tencentdeepseek-v3-volcenginedeepseek-r1-volcenginedeepseek-v3-siliconflowdeepseek-r1-siliconflowabab7-chat-previewabab6.5s-chatMiniMax-Text-01hunyuan-litehunyuan-large-longcontexthunyuan-largehunyuan-standard-256Khunyuan-visionernie-4.0-turbo-128kernie-3.5-128kernie-speed-128kyi-largeyi-lightningyi-medium-200kyi-visionBaichuan4-TurboBaichuan4-AirBaichuan3-Turbo-128kLiteMax-32K4.0Ultramoonshot-v1-8kmoonshot-v1-32kmoonshot-v1-128kmoonshot-v1-8k-vision-previewmoonshot-v1-32k-vision-previewmoonshot-v1-128k-vision-previewgpt-4o-minigpt-4oo1-minio1-previewo3-miniClaude-3.5-Sonnetgemini-1.5-progemini-2.0-pro-exp-02-05gemini-2.0-flash-001gemini-2.0-flash-lite-preview-02-05gemini-2.0-flash-thinking-exp-01-21

默认值:

abab6.5s-chat

示例值:

deepseek-chat

max_tokens

integer

可选

(自定义参数)LLM 大语言模型调用时的max_tokens

>= 20<= 8000

默认值:

50

示例值:

30

asr_model

enum<string>

可选

(自定义参数)ASR 语音识别模型选择

枚举值:

TX_ASR_sentence_8k_zhTX_ASR_sentence_16k_zhTX_ASR_sentence_8k_enTX_ASR_sentence_16k_zh-PYTX_ASR_sentence_16k_zh-TWTX_ASR_sentence_16k_zh-eduTX_ASR_sentence_16k_zh-medicalTX_ASR_sentence_16k_zh-courtTX_ASR_sentence_16k_yueTX_ASR_sentence_16k_enTX_ASR_sentence_16k_en_gameTX_ASR_sentence_16k_en_eduTX_ASR_sentence_16k_jaTX_ASR_sentence_16k_koTX_ASR_sentence_16k_viTX_ASR_sentence_16k_msTX_ASR_sentence_16k_idTX_ASR_sentence_16k_filTX_ASR_sentence_16k_thTX_ASR_sentence_16k_ptTX_ASR_sentence_16k_trTX_ASR_sentence_16k_arTX_ASR_sentence_16k_esTX_ASR_sentence_16k_hiTX_ASR_sentence_16k_frTX_ASR_sentence_16k_deTX_ASR_sentence_16k_zh_dialectZJ_ASR_sentenceALI_ASR_long_paraformer-v1ALI_ASR_long_paraformer-v2ALI_ASRL_long_sensevoice-v1

默认值:

TX_ASR_realtime_16k_zh

示例值:

TX_ASR_sentence_16k_zh

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

示例值:

ALI_TTSL_realtime_cosyvoice-v1

示例代码

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/v1/agent/chat_bot_v1/' \
--header 'Authorization: Bearer ' \
--form 'mode="customize"' \
--form 'audio_file=@"C:\\Users\\lery\\Downloads\\你好，很高兴认识你.wav"' \
--form 'emotion_output="true"' \
--form 'voice_id="10510000"' \
--form 'output_format="mp3"' \
--form 'speed="1"' \
--form 'stream="true"' \
--form 'user_age="5"' \
--form 'bot_name="智酱"' \
--form 'bot_description="你是住在芯片王国里的AI机器人，可以帮助用户解决各式各样的问题"' \
--form 'bot_character="朋友"' \
--form 'bot_personality="有趣"' \
--form 'bot_response_style="normal"' \
--form 'max_tokens="30"' \
--form 'asr_model="TX_ASR_sentence_16k_zh"' \
--form 'tts_model="ALI_TTSL_realtime_cosyvoice-v1"'

返回响应

🟢200成功

application/json

Body

message

string

必需

status

integer

必需

data

object

必需

asr_content

string

必需

llm_response

string

必需

emotion_value

enum<string>

必需

枚举值:

开心同情鼓励生气期待委屈其他

tts_audio

string

必需

示例

{
  "message": "",
  "status": 200,
  "data": {
    "asr_content": "您好，很高兴认识您。",
    "llm_response": "嗨嗨，你好呀！我也很高兴认识你，我们来玩个游戏吧？",
    "emotion_value": "开心",
    "tts_audio": "https://genitop-1317577547.cos.ap-nanjing.myqcloud.com/mindcraft_media/api_file/8c5a234f-d94a-4831-a607-6cfda8f3b615.mp3"
  }
}

🟢200流体数据

chat_bot_v1(自定义customize)

使用 python 代码请求#

请求参数

示例代码

返回响应

使用 python 代码请求