chat_bot_v1 接口汇总

请求参数

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二选一。

asr_uuid

string

必需

1.

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

2.

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

3.

asr_uuid和audio_file二选一。

示例值:

CU-xxx

upload_format

enum<string>

可选

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

枚举值:

wavpcmogg-opusspeexsilkmp3m4aaacamr

默认值:

wav

示例值:

wav

emotion_output

boolean

是否启动识别情绪

可选

默认值:

false

示例值:

true

voice_id

string

必需

机器人的语音音色。MiniMax和腾讯语音合成对应的音色请参考TTS 音色列表

示例值:

female-tianmei

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

示例值:

conversation

session_token

string

可选

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

示例值:

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-pro-32kDoubao-1.5-pro-256kDoubao-1.5-lite-32kDoubao-1.5-vision-pro-32kDoubao-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-8k-previewernie-x1-32k-previewernie-4.0-turbo-128kernie-3.5-128kernie-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-1.5-progemini-2.5-pro-preview-03-25gemini-2.0-flash-exp-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

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_zhBD_TTSL_realtime_zh

默认值:

TX_TTSP_realtime

示例值:

speech-01-turbo

示例代码

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=@""' \
--form 'upload_format="wav"' \
--form 'emotion_output="true"' \
--form 'voice_id="female-tianmei"' \
--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="conversation"' \
--form 'max_tokens="30"' \
--form 'tts_model="speech-01-turbo"'

返回响应

🟢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 接口汇总

使用 python 代码请求#

请求参数

示例代码

返回响应

使用 python 代码请求