chat_bot_v1(标准standard)

请求参数

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参数才可以自己设置。

枚举值:

standard

默认值:

customize

示例值:

standard

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

示例值:

CU-xxx

upload_format

enum<string>

可选

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

枚举值:

wavpcmogg-opusspeexsilkmp3m4aaacamr

默认值:

wav

示例值:

wav

emotion_output

boolean

是否启动识别情绪

可选

默认值:

false

示例值:

true

voice_id

enum<string>

必需

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

枚举值:

100510000101001101002101003101004101005101006101007101008101009101010101011101012101013101014101015101016101017101018101019101020101021101022101023101024101025101026101027101028101029101030101031101032101033101081101080101034101035101040101050101051101052101053101054101055101056101057301000301001301002301003301004301005301006301007301008301009301010301011301012301013301014301015301016301017301018301019301020301021301022301023301024301025301026301027301028301029301030301031301032301033301034301035301036301037301038301039301040301041

示例值:

301036

output_format

enum<string>

可选

TTS 语音合成返回格式

枚举值:

mp3wavpcmflacaac

默认值:

mp3

示例值:

mp3

speed

number

可选

TTS 语音合成语速控制

>= 0.5<= 2

默认值:

1

示例值:

1

stream

boolean

流体内容回复

可选

示例值:

false

user_age

string

用户年龄设置

可选

示例值:

5

bot_name

string

机器人姓名设置

可选

默认值:

智酱

示例值:

智酱

bot_description

string

机器人角色介绍

可选

示例值:

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

bot_character

string

机器人角色设置

可选

默认值:

朋友

示例值:

朋友

bot_personality

string

机器人性格设置

可选

默认值:

有趣

示例值:

有趣

bot_response_style

enum<string>

机器人回复风格设定

可选

枚举值:

normalconversation

session_token

string

可选

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

示例值:

e8eec3b3-c75f-4390-8a68-adf369c50fbe

示例代码

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="standard"' \
--form 'audio_file=@"C:\\Users\\lery\\Downloads\\你好，很高兴认识你.wav"' \
--form 'emotion_output="true"' \
--form 'voice_id="301036"' \
--form 'output_format="mp3"' \
--form 'speed="1"' \
--form 'stream="false"' \
--form 'user_age="5"' \
--form 'bot_name="智酱"' \
--form 'bot_description="你是住在芯片王国里的AI机器人，可以帮助用户解决各式各样的问题"' \
--form 'bot_character="朋友"' \
--form 'bot_personality="有趣"' \
--form 'bot_response_style=""'

返回响应

🟢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://api.mindcraft.com.cn/static/scratch_file/mindcraft_media/api_file/ba0e13d5-c0d6-4ff5-a5ff-f1d7cadedfe8.mp3",
    "audio_seconds": 8.07
  }
}

🟢200流体数据

chat_bot_v1(标准standard)

使用 python 代码请求#

请求参数

示例代码

返回响应

使用 python 代码请求