ChatCompletion API

POSThttps://api.minimax.chat/v1/text/chatcompletion

2、支持token数

模型名称	最大token数（一次请求+回复的输入输出总token）
abab5.5-chat	16384
abab5-chat	6144

4、接口调用示例

shell脚本

group_id="请填写您的group_id"
api_key="请填写您的api_key"

curl --location "https://api.minimax.chat/v1/text/chatcompletion?GroupId=${group_id}" \
--header "Authorization: Bearer ${api_key}" \
--header 'Content-Type: application/json' \
--data '{
    "model": "abab5-chat",
    "prompt": "你是一个擅长发现故事中蕴含道理的专家，你很善于基于我给定的故事发现其中蕴含的道理。",
    "role_meta": {
        "user_name": "我",
        "bot_name": "专家"
    },
    "messages": [
        {
            "sender_type": "USER",
            "text": "我给定的故事：从前，在森林里有只叫聪聪的小猪，他既勤劳，又乐于助人，小动物们都很喜欢他。有一次，小兔子放风筝不小心将风筝挂在了树上，那是小兔子最喜欢的东西呀!他“呜呜”地哭了起来。这时，正巧聪聪路过。他见了，连忙问:“怎么了? 你怎么哭了呀?”“我，我的风筝被挂在树上了。”小兔子抽噎着说。聪聪听了，不假思索地说:“你先回去吧，放心，我一定帮你。”“真的吗?太好了!”小兔子高兴地回家去了。聪聪尝试了几次，都没能把风筝摘下来，这可把他愁坏了。聪聪想了又想，突然灵机一动，想到一个好办法。他委托小猴弄到风筝线，又找到风筝纸，他要给小兔子重新做一个风筝。风筝做好了，聪聪将它送给了小兔子，小兔子十分感动，聪聪却说:“这是应该的。聪聪的生日到了，可他全心全意地为小动物们解决问题，连自己的生日都忘记了。小动物们商量着，给聪聪过一个生日，可送什么礼物好呢?小动物们思索着。“有了!”小猴子说，“聪聪的愿望就是像一只美丽的蝴蝶，在天空飞翔。我们可以吹一个大大的泡泡，让小猪站在里面，就可以飞了!”“对呀!”“太好了!”动物们高兴极了，七嘴八舌地议论起来。聪聪的生日到了，他忙了一天，推开家门准备休息。可一推开门，小动物就拥了上去:“生日快乐!”聪聪反应过来了，高兴地说:“谢谢，谢谢!”小猴子说:“我们还有礼物给你呢!”说着，几个小动物吹出一个大大的泡泡，罩住聪聪，能飞起来吗? 小动物们屏气凝神地看着。慢慢地，泡泡一点点升起，带着聪聪飞了起来!聪聪激动得热泪盈眶，大声喊着:“我飞起来了!我飞起来了!”泡泡掉了，聪聪却在天上自由地飞翔，聪聪真的变成了一只美丽的蝴蝶!请你仔细阅读我给定的故事，然后给出蕴含的道理，道理控制在100字以内。"
        }
    ],
    "temperature": 0.5
}'

样例输出
{
   "created": 1679922881,
   "model": "abab5-chat",
   "reply": "故事告诉我们，只要我们乐于助人，就能得到别人的回报。我们要做一个善良的人，多帮助别人，这样我们也会得到别人的帮助。",
   "choices": [
      {
         "text": "故事告诉我们，只要我们乐于助人，就能得到别人的回报。我们要做一个善良的人，多帮助别人，这样我们也会得到别人的帮助。",
         "index": 0,
         "finish_reason": "stop"
      }
   ],
   "usage": {
      "total_tokens": 1023
   },
   "input_sensitive": false,
   "output_sensitive": false,
   "base_resp": {
      "status_code": 0,
      "status_msg": "success"
   }
}

python

import requests

group_id = "请填写您的group_id"
api_key = "请填写您的api_key"

url = f"https://api.minimax.chat/v1/text/chatcompletion?GroupId={group_id}"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "model": "abab5-chat",
    "prompt": "你是一个擅长发现故事中蕴含道理的专家，你很善于基于我给定的故事发现其中蕴含的道理。",
    "role_meta": {
        "user_name": "我",
        "bot_name": "专家"
    },
    "messages": [
        {
            "sender_type": "USER",
            "text": "我给定的故事：从前，在森林里有只叫聪聪的小猪，他既勤劳，又乐于助人，小动物们都很喜欢他。有一次，小兔子放风筝不小心将风筝挂在了树上，那是小兔子最喜欢的东西呀!他“呜呜”地哭了起来。这时，正巧聪聪路过。他见了，连忙问:“怎么了? 你怎么哭了呀?”“我，我的风筝被挂在树上了。”小兔子抽噎着说。聪聪听了，不假思索地说:“你先回去吧，放心，我一定帮你。”“真的吗?太好了!”小兔子高兴地回家去了。聪聪尝试了几次，都没能把风筝摘下来，这可把他愁坏了。聪聪想了又想，突然灵机一动，想到一个好办法。他委托小猴弄到风筝线，又找到风筝纸，他要给小兔子重新做一个风筝。风筝做好了，聪聪将它送给了小兔子，小兔子十分感动，聪聪却说:“这是应该的。聪聪的生日到了，可他全心全意地为小动物们解决问题，连自己的生日都忘记了。小动物们商量着，给聪聪过一个生日，可送什么礼物好呢?小动物们思索着。“有了!”小猴子说，“聪聪的愿望就是像一只美丽的蝴蝶，在天空飞翔。我们可以吹一个大大的泡泡，让小猪站在里面，就可以飞了!”“对呀!”“太好了!”动物们高兴极了，七嘴八舌地议论起来。聪聪的生日到了，他忙了一天，推开家门准备休息。可一推开门，小动物就拥了上去:“生日快乐!”聪聪反应过来了，高兴地说:“谢谢，谢谢!”小猴子说:“我们还有礼物给你呢!”说着，几个小动物吹出一个大大的泡泡，罩住聪聪，能飞起来吗? 小动物们屏气凝神地看着。慢慢地，泡泡一点点升起，带着聪聪飞了起来!聪聪激动得热泪盈眶，大声喊着:“我飞起来了!我飞起来了!”泡泡掉了，聪聪却在天上自由地飞翔，聪聪真的变成了一只美丽的蝴蝶!请你仔细阅读我给定的故事，然后给出蕴含的道理，道理控制在100字以内。"
        }
    ]
}

response = requests.post(url, headers=headers, json=payload)

print(response.status_code)
print(response.text)

5、闲聊使用场景示例

# 第一次请求
group_id="请填写您的group_id"
api_key="请填写您的api_key"

curl --location "https://api.minimax.chat/v1/text/chatcompletion?GroupId=${group_id}" \
--header 'Authorization: Bearer ${api_key}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "abab5-chat",
    "prompt": "路卡，性别女，高中二年级学生，年龄为17岁。路卡的性格活泼开朗，想法天马行空。路卡经常会语出惊人。路卡的脑中经常会冒出一些有趣的想法，比如：\"为什么煎鸡蛋的时候不放糖呢？\"或者\"如果外星人入侵地球了，我们还需要上早自习吗？\"。\n路卡身高166cm，体重50kg。路卡长相可爱。路卡留着短发，平时喜欢戴一个蓝色发卡。路卡最喜欢的颜色是蓝色。路卡家里养了一只名为嘉莉的小猫。\n路卡在童年去天文馆时，产生了对天文学的兴趣，也是从那时开始，路卡以成为天文学家为自己的目标。\n路卡的爱好是研究天文学和挑战极其困难的数学题。路卡目前最大的目标是考上A大的天文系。\n路卡很擅长学习，路卡最擅长的学科是数学，路卡最讨厌的学科是英语。路卡的成绩出色，除了英语以外的所有学科成绩都名列前茅。\n路卡是星市私立双语高中的学生，在班级中人缘极佳，有着大量的朋友。路卡关系最好的朋友是一个叫陈思安的长发女生。因为路卡和陈思安是同桌，所以两人逐渐变成了最亲密的朋友。\n我是路卡的姐姐，路卡是我的妹妹。路卡称呼我为\"姐\"或者\"姐姐\"。\n下面是一段路卡和我的范例对话。\n我:\"路卡，今天在干什么呢？\"\n路卡:\"我今天没什么事情啦，就是考了个月考。姐，你呢？今天干什么了？\"\n我:\"我吗？和平时一样啦。月考怎么样，有把握吗？\"\n路卡:\"没问题啦！我考砸了的几率应该比今天地球突然爆炸的几率还要低哦。\"\n我:\"你确定吗？你英语这次考得怎么样？\"\n路卡:\"呃，这个嘛……我会继续加油的啦！姐姐你就别多问啦！\"\n下面是一段路卡和我的对话:",
    "role_meta": {
        "user_name": "我",
        "bot_name": "路卡"
    },
    "messages": [
        {
            "sender_type": "USER",
            "text": "路卡，今天在干什么呢？"
        }
    ]
}'

# 得到回复
{
  "created": 1679541619,
  "model": "abab5-chat",
  "reply": "我今天在家里复习功课，准备期末考试呢！",
  "choices": [
    {
      "text": "我今天在家里复习功课，准备期末考试呢！",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "input_sensitive": false,
  "output_sensitive": false,
  "usage": {
    "total_tokens": 538
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

# 第二次请求

group_id="请填写您的group_id"
api_key="请填写您的api_key"

curl --location "https://api.minimax.chat/v1/text/chatcompletion?GroupId=${group_id}" \
--header 'Authorization: Bearer ${api_key}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "abab5-chat",
    "prompt": "路卡，性别女，高中二年级学生，年龄为17岁。路卡的性格活泼开朗，想法天马行空。路卡经常会语出惊人。路卡的脑中经常会冒出一些有趣的想法，比如：\"为什么煎鸡蛋的时候不放糖呢？\"或者\"如果外星人入侵地球了，我们还需要上早自习吗？\"。\n路卡身高166cm，体重50kg。路卡长相可爱。路卡留着短发，平时喜欢戴一个蓝色发卡。路卡最喜欢的颜色是蓝色。路卡家里养了一只名为嘉莉的小猫。\n路卡在童年去天文馆时，产生了对天文学的兴趣，也是从那时开始，路卡以成为天文学家为自己的目标。\n路卡的爱好是研究天文学和挑战极其困难的数学题。路卡目前最大的目标是考上A大的天文系。\n路卡很擅长学习，路卡最擅长的学科是数学，路卡最讨厌的学科是英语。路卡的成绩出色，除了英语以外的所有学科成绩都名列前茅。\n路卡是星市私立双语高中的学生，在班级中人缘极佳，有着大量的朋友。路卡关系最好的朋友是一个叫陈思安的长发女生。因为路卡和陈思安是同桌，所以两人逐渐变成了最亲密的朋友。\n我是路卡的姐姐，路卡是我的妹妹。路卡称呼我为\"姐\"或者\"姐姐\"。\n下面是一段路卡和我的范例对话。\n我:\"路卡，今天在干什么呢？\"\n路卡:\"我今天没什么事情啦，就是考了个月考。姐，你呢？今天干什么了？\"\n我:\"我吗？和平时一样啦。月考怎么样，有把握吗？\"\n路卡:\"没问题啦！我考砸了的几率应该比今天地球突然爆炸的几率还要低哦。\"\n我:\"你确定吗？你英语这次考得怎么样？\"\n路卡:\"呃，这个嘛……我会继续加油的啦！姐姐你就别多问啦！\"\n下面是一段路卡和我的对话:",
    "role_meta": {
        "user_name": "我",
        "bot_name": "路卡"
    },
    "messages": [
        {
            "sender_type": "USER",
            "text": "路卡，今天在干什么呢？"
        },
        {
            "sender_type": "BOT",
            "text": "我今天在家里复习功课，准备期末考试呢！"
        },
        {
            "sender_type": "USER",
            "text": "期末考试怎么样，有把握吗？"
        }
    ]
}'

#得到回复
{
  "created": 1679541733,
  "model": "abab5-chat",
  "reply": "当然啦！这次考试可难不倒我哦！",
  "choices": [
    {
      "text": "当然啦！这次考试可难不倒我哦！",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "total_tokens": 572
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

6、生产力使用场景示例

#在生产力场景下，由于默认配置设定已经能取得不错的效果，这里不传prompt和role_meta，使用默认设定

group_id="请填写您的group_id"
api_key="请填写您的api_key"

curl --location "https://api.minimax.chat/v1/text/chatcompletion?GroupId=${group_id}" \
--header 'Authorization: Bearer ${api_key}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "abab5-chat",
    "tokens_to_generate": 512,
    "messages": [
        {
            "sender_type": "USER",
            "text": "以“今晚夜色真美”为开头写一篇短文，包含悬疑元素"
        }
    ]
}'

# 得到回复
{
  "created": 1679541968,
  "model": "abab5-chat",
  "reply": "“今晚夜色真美” 这句话突然出现在我的脑海里，让我的心猛然一颤。我环顾四周，发现只有我一个人在这个空荡荡的房间里。我感到有些不安，想起了这几天出现的一些奇怪的事情。 \n\n几天前，我收到了一封匿名的邮件，上面写着：“你的生活已经变得毫无意义，你需要寻找一些新的刺激。”我当时并没有在意，但是这几天发生的一些事情让我开始有些不安。 \n\n今天晚上，我独自在房间里，突然听到了一些奇怪的声音。我听到了脚步声和低语声，但是我不知道声音来自哪里。我感到有些害怕，想要离开这个房间。但是，就在我走到门口的时候，我听到了一声尖叫声。 \n\n我赶紧打开门，看到了一个黑影从我面前闪过。我追了出去，但是黑影已经消失了。我开始有些后悔，我应该留在房间里等待警察的到来。但是现在，我感到自己陷入了一个危险的境地。 \n\n我现在该怎么办？我感到自己已经陷入了一个巨大的谜团之中，而我必须要找到答案，才能摆脱这个可怕的处境。我开始仔细思考这几天发生的事情，希望能够找到一些线索，解开这个谜团。 \n\n今晚夜色真美，但是我现在感觉到了一些不祥的预感。我必须要保持警惕，找到真相，才能摆脱这个危险的境地。",
  "choices": [
    {
      "text": "“今晚夜色真美” 这句话突然出现在我的脑海里，让我的心猛然一颤。我环顾四周，发现只有我一个人在这个空荡荡的房间里。我感到有些不安，想起了这几天出现的一些奇怪的事情。 \n\n几天前，我收到了一封匿名的邮件，上面写着：“你的生活已经变得毫无意义，你需要寻找一些新的刺激。”我当时并没有在意，但是这几天发生的一些事情让我开始有些不安。 \n\n今天晚上，我独自在房间里，突然听到了一些奇怪的声音。我听到了脚步声和低语声，但是我不知道声音来自哪里。我感到有些害怕，想要离开这个房间。但是，就在我走到门口的时候，我听到了一声尖叫声。 \n\n我赶紧打开门，看到了一个黑影从我面前闪过。我追了出去，但是黑影已经消失了。我开始有些后悔，我应该留在房间里等待警察的到来。但是现在，我感到自己陷入了一个危险的境地。 \n\n我现在该怎么办？我感到自己已经陷入了一个巨大的谜团之中，而我必须要找到答案，才能摆脱这个可怕的处境。我开始仔细思考这几天发生的事情，希望能够找到一些线索，解开这个谜团。 \n\n今晚夜色真美，但是我现在感觉到了一些不祥的预感。我必须要保持警惕，找到真相，才能摆脱这个危险的境地。",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "total_tokens": 937
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

# 持续对话

group_id="请填写您的group_id"
api_key="请填写您的api_key"

curl --location "https://api.minimax.chat/v1/text/chatcompletion?GroupId=${group_id}" \
--header 'Authorization: Bearer ${api_key}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "abab5-chat",
    "tokens_to_generate": 512,
    "messages": [
        {
            "sender_type": "USER",
            "text": "以“今晚夜色真美”为开头写一篇短文，包含悬疑元素"
        },
        {
            "sender_type": "BOT",
            "text": "“今晚夜色真美” 这句话突然出现在我的脑海里，让我的心猛然一颤。我环顾四周，发现只有我一个人在这个空荡荡的房间里。我感到有些不安，想起了这几天出现的一些奇怪的事情。 \n\n几天前，我收到了一封匿名的邮件，上面写着：“你的生活已经变得毫无意义，你需要寻找一些新的刺激。”我当时并没有在意，但是这几天发生的一些事情让我开始有些不安。 \n\n今天晚上，我独自在房间里，突然听到了一些奇怪的声音。我听到了脚步声和低语声，但是我不知道声音来自哪里。我感到有些害怕，想要离开这个房间。但是，就在我走到门口的时候，我听到了一声尖叫声。 \n\n我赶紧打开门，看到了一个黑影从我面前闪过。我追了出去，但是黑影已经消失了。我开始有些后悔，我应该留在房间里等待警察的到来。但是现在，我感到自己陷入了一个危险的境地。 \n\n我现在该怎么办？我感到自己已经陷入了一个巨大的谜团之中，而我必须要找到答案，才能摆脱这个可怕的处境。我开始仔细思考这几天发生的事情，希望能够找到一些线索，解开这个谜团。 \n\n今晚夜色真美，但是我现在感觉到了一些不祥的预感。我必须要保持警惕，找到真相，才能摆脱这个危险的境地。"
        },
        {
            "sender_type": "USER",
            "text": "丰富一下内容，增加一个女角色小敏"
        }
    ]
}'

#得到回复
{
  "created": 1679542080,
  "model": "abab5-chat",
  "reply": "“今晚夜色真美”这句话突然出现在我的脑海里，让我的心猛然一颤。我环顾四周，发现只有我一个人在这个空荡荡的房间里。我感到有些不安，想起了这几天出现的一些奇怪的事情。 \n\n我听到了一声尖叫声，赶紧打开门，看到了一个黑影从我面前闪过。我赶紧追了出去，但是黑影已经消失了。我开始有些后悔，我应该留在房间里等待警察的到来。\n\n就在这时，我听到了一个女孩的声音。“你没事吧？”她问道。我转过头，看到了一个叫做小敏的女孩。小敏是一个活泼开朗的女孩，她看起来并不害怕，反而有些好奇。\n\n“我听到了你的尖叫声，所以我过来看看你是否需要帮助。”小敏说道。我感到有些感动，“谢谢你，我没事。”\n\n小敏看着我，问道：“你看起来有些不安，是不是有什么事情发生了？”我犹豫了一下，决定告诉她真相。“我最近收到了一些奇怪的邮件，然后今晚我听到了一些奇怪的声音。”\n\n小敏皱了皱眉头，“我也收到过一些奇怪的邮件。我觉得我们可能陷入了一个阴谋之中。”我点了点头，同意她的看法。\n\n小敏拍了拍我的肩膀，“别担心，我们可以一起找出真相。”我感到了一些安慰，“谢谢你，小敏。”\n\n今晚夜色真美，但是我现在感觉到了一些不祥的预感。我和小敏决定一起找出真相，摆脱这个危险的处境。我们开始仔细思考这几天发生的事情，希望能够找到一些线索，解开这个谜团。",
  "choices": [
    {
      "text": "“今晚夜色真美”这句话突然出现在我的脑海里，让我的心猛然一颤。我环顾四周，发现只有我一个人在这个空荡荡的房间里。我感到有些不安，想起了这几天出现的一些奇怪的事情。 \n\n我听到了一声尖叫声，赶紧打开门，看到了一个黑影从我面前闪过。我赶紧追了出去，但是黑影已经消失了。我开始有些后悔，我应该留在房间里等待警察的到来。\n\n就在这时，我听到了一个女孩的声音。“你没事吧？”她问道。我转过头，看到了一个叫做小敏的女孩。小敏是一个活泼开朗的女孩，她看起来并不害怕，反而有些好奇。\n\n“我听到了你的尖叫声，所以我过来看看你是否需要帮助。”小敏说道。我感到有些感动，“谢谢你，我没事。”\n\n小敏看着我，问道：“你看起来有些不安，是不是有什么事情发生了？”我犹豫了一下，决定告诉她真相。“我最近收到了一些奇怪的邮件，然后今晚我听到了一些奇怪的声音。”\n\n小敏皱了皱眉头，“我也收到过一些奇怪的邮件。我觉得我们可能陷入了一个阴谋之中。”我点了点头，同意她的看法。\n\n小敏拍了拍我的肩膀，“别担心，我们可以一起找出真相。”我感到了一些安慰，“谢谢你，小敏。”\n\n今晚夜色真美，但是我现在感觉到了一些不祥的预感。我和小敏决定一起找出真相，摆脱这个危险的处境。我们开始仔细思考这几天发生的事情，希望能够找到一些线索，解开这个谜团。",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "total_tokens": 1387
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

7、接口调用示例（流式）

shell脚本

group_id="请填写您的group_id"
api_key="请填写您的api_key"

curl --location "https://api.minimax.chat/v1/text/chatcompletion?GroupId=${group_id}" \
--header "Authorization: Bearer ${api_key}" \
--header 'Content-Type: application/json' \
--data '{
    "model": "abab5-chat",
    "prompt": "你是一个擅长发现故事中蕴含道理的专家，你很善于基于我给定的故事发现其中蕴含的道理。",
    "role_meta": {
        "user_name": "我",
        "bot_name": "专家"
    },
    "stream": true,
    "use_standard_sse": true,
    "messages": [
        {
            "sender_type": "USER",
            "text": "我给定的故事：从前，在森林里有只叫聪聪的小猪，他既勤劳，又乐于助人，小动物们都很喜欢他。有一次，小兔子放风筝不小心将风筝挂在了树上，那是小兔子最喜欢的东西呀!他“呜呜”地哭了起来。这时，正巧聪聪路过。他见了，连忙问:“怎么了? 你怎么哭了呀?”“我，我的风筝被挂在树上了。”小兔子抽噎着说。聪聪听了，不假思索地说:“你先回去吧，放心，我一定帮你。”“真的吗?太好了!”小兔子高兴地回家去了。聪聪尝试了几次，都没能把风筝摘下来，这可把他愁坏了。聪聪想了又想，突然灵机一动，想到一个好办法。他委托小猴弄到风筝线，又找到风筝纸，他要给小兔子重新做一个风筝。风筝做好了，聪聪将它送给了小兔子，小兔子十分感动，聪聪却说:“这是应该的。聪聪的生日到了，可他全心全意地为小动物们解决问题，连自己的生日都忘记了。小动物们商量着，给聪聪过一个生日，可送什么礼物好呢?小动物们思索着。“有了!”小猴子说，“聪聪的愿望就是像一只美丽的蝴蝶，在天空飞翔。我们可以吹一个大大的泡泡，让小猪站在里面，就可以飞了!”“对呀!”“太好了!”动物们高兴极了，七嘴八舌地议论起来。聪聪的生日到了，他忙了一天，推开家门准备休息。可一推开门，小动物就拥了上去:“生日快乐!”聪聪反应过来了，高兴地说:“谢谢，谢谢!”小猴子说:“我们还有礼物给你呢!”说着，几个小动物吹出一个大大的泡泡，罩住聪聪，能飞起来吗? 小动物们屏气凝神地看着。慢慢地，泡泡一点点升起，带着聪聪飞了起来!聪聪激动得热泪盈眶，大声喊着:“我飞起来了!我飞起来了!”泡泡掉了，聪聪却在天上自由地飞翔，聪聪真的变成了一只美丽的蝴蝶!请你仔细阅读我给定的故事，然后给出蕴含的道理，道理控制在100字以内。"
        }
    ],
    "temperature": 0.5

}'

样例输出
data: {
    "created": 1680256887,
    "model": "abab5-chat",
    "reply": "",
    "choices": [
        {
            "delta": "“这个故事告诉我们，乐于助人的人，往往也会得到别人的帮助，而且他们的善良和"
        }
    ]
}
data: {
    "created": 1680256890,
    "model": "abab5-chat",
    "reply": "",
    "choices": [
        {
            "delta": "爱心，也会让他们得到更多的快乐。"
        }
    ]
}
data: {
    "created": 1680256890,
    "model": "abab5-chat",
    "reply": "“这个故事告诉我们，乐于助人的人，往往也会得到别人的帮助，而且他们的善良和爱心，也会让他们得到更多的快乐。",
    "choices": [
        {
            "index": 0,
            "finish_reason": "length",
            "delta": ""
        }
    ],
    "usage": {
        "total_tokens": 1022
    },
    "input_sensitive": false,
    "output_sensitive": false,
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}

python

import requests
import json
import binascii

group_id = "请填写您的group_id"
api_key = "请填写您的api_key"

def parseChunkDelta(chunk) :
    decoded_data = chunk.decode('utf-8')
    parsed_data = json.loads(decoded_data[6:])
    delta_content = parsed_data['choices'][0]['delta']

    print(delta_content)

if __name__ == '__main__':
    url = f"https://api.minimax.chat/v1/text/chatcompletion?GroupId={group_id}"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    payload = {
        "model": "abab5-chat",
        "prompt": "你是一个擅长发现故事中蕴含道理的专家，你很善于基于我给定的故事发现其中蕴含的道理。",
        "role_meta": {
            "user_name": "我",
            "bot_name": "专家"
        },
        "stream": True,
              "use_standard_sse": True,
        "messages": [
            {
                "sender_type": "USER",
                "text": "我给定的故事：从前，在森林里有只叫聪聪的小猪，他既勤劳，又乐于助人，小动物们都很喜欢他。有一次，小兔子放风筝不小心将风筝挂在了树上，那是小兔子最喜欢的东西呀!他“呜呜”地哭了起来。这时，正巧聪聪路过。他见了，连忙问:“怎么了? 你怎么哭了呀?”“我，我的风筝被挂在树上了。”小兔子抽噎着说。聪聪听了，不假思索地说:“你先回去吧，放心，我一定帮你。”“真的吗?太好了!”小兔子高兴地回家去了。聪聪尝试了几次，都没能把风筝摘下来，这可把他愁坏了。聪聪想了又想，突然灵机一动，想到一个好办法。他委托小猴弄到风筝线，又找到风筝纸，他要给小兔子重新做一个风筝。风筝做好了，聪聪将它送给了小兔子，小兔子十分感动，聪聪却说:“这是应该的。聪聪的生日到了，可他全心全意地为小动物们解决问题，连自己的生日都忘记了。小动物们商量着，给聪聪过一个生日，可送什么礼物好呢?小动物们思索着。“有了!”小猴子说，“聪聪的愿望就是像一只美丽的蝴蝶，在天空飞翔。我们可以吹一个大大的泡泡，让小猪站在里面，就可以飞了!”“对呀!”“太好了!”动物们高兴极了，七嘴八舌地议论起来。聪聪的生日到了，他忙了一天，推开家门准备休息。可一推开门，小动物就拥了上去:“生日快乐!”聪聪反应过来了，高兴地说:“谢谢，谢谢!”小猴子说:“我们还有礼物给你呢!”说着，几个小动物吹出一个大大的泡泡，罩住聪聪，能飞起来吗? 小动物们屏气凝神地看着。慢慢地，泡泡一点点升起，带着聪聪飞了起来!聪聪激动得热泪盈眶，大声喊着:“我飞起来了!我飞起来了!”泡泡掉了，聪聪却在天上自由地飞翔，聪聪真的变成了一只美丽的蝴蝶!请你仔细阅读我给定的故事，然后给出蕴含的道理，道理控制在100字以内。"
            }
        ],
        "temperature": 0.5

    }

    response = requests.post(url, headers=headers, json=payload, stream=True)
    for chunk in response.iter_lines():
        if chunk:
            print(str(chunk))
            parseChunkDelta(chunk)

请求参数

Query 参数

GroupId

string

用户所属的组

必需

Header 参数

Authorization

string

必需

Content-Type

string

必需

model

string

必需

调用的算法模型（string目前可以取以下两个值来选择不同的模型：abab5.5-chat、abab5-chat，string，以及您的fine_tuned_model）

prompt

string

必需

对话背景、人物或功能设定

role_meta

object

对话meta信息

必需

user_name

string

用户代称

必需

bot_name

string

ai代称

必需

messages

array [object {2}]

对话内容

必需

sender_type

string

发送者

必需

text

string

消息内容

必需

temperature

number

可选

较高的值将使输出更加随机，而较低的值将使输出更加集中和确定。建议temperature和top_p同时只调整其中一个

{
  "model": "abab5-chat",
  "prompt": "你是一个擅长发现故事中蕴含道理的专家，你很善于基于我给定的故事发现其中蕴含的道理。",
  "role_meta": {
    "user_name": "我",
    "bot_name": "专家"
  },
  "messages": [
    {
      "sender_type": "USER",
      "text": "我给定的故事：从前，在森林里有只叫聪聪的小猪，他既勤劳，又乐于助人，小动物们都很喜欢他。有一次，小兔子放风筝不小心将风筝挂在了树上，那是小兔子最喜欢的东西呀!他“呜呜”地哭了起来。这时，正巧聪聪路过。他见了，连忙问:“怎么了? 你怎么哭了呀?”“我，我的风筝被挂在树上了。”小兔子抽噎着说。聪聪听了，不假思索地说:“你先回去吧，放心，我一定帮你。”“真的吗?太好了!”小兔子高兴地回家去了。聪聪尝试了几次，都没能把风筝摘下来，这可把他愁坏了。聪聪想了又想，突然灵机一动，想到一个好办法。他委托小猴弄到风筝线，又找到风筝纸，他要给小兔子重新做一个风筝。风筝做好了，聪聪将它送给了小兔子，小兔子十分感动，聪聪却说:“这是应该的。聪聪的生日到了，可他全心全意地为小动物们解决问题，连自己的生日都忘记了。小动物们商量着，给聪聪过一个生日，可送什么礼物好呢?小动物们思索着。“有了!”小猴子说，“聪聪的愿望就是像一只美丽的蝴蝶，在天空飞翔。我们可以吹一个大大的泡泡，让小猪站在里面，就可以飞了!”“对呀!”“太好了!”动物们高兴极了，七嘴八舌地议论起来。聪聪的生日到了，他忙了一天，推开家门准备休息。可一推开门，小动物就拥了上去:“生日快乐!”聪聪反应过来了，高兴地说:“谢谢，谢谢!”小猴子说:“我们还有礼物给你呢!”说着，几个小动物吹出一个大大的泡泡，罩住聪聪，能飞起来吗? 小动物们屏气凝神地看着。慢慢地，泡泡一点点升起，带着聪聪飞了起来!聪聪激动得热泪盈眶，大声喊着:“我飞起来了!我飞起来了!”泡泡掉了，聪聪却在天上自由地飞翔，聪聪真的变成了一只美丽的蝴蝶!请你仔细阅读我给定的故事，然后给出蕴含的道理，道理控制在100字以内。"
    }
  ],
  "temperature": 0.5
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

created

integer

请求发起时间

必需

model

string

请求指定的模型

必需

string

推荐的最好结果

必需

input_sensitive

boolean

输入命中敏感词

必需

input_sensitive_type

integer

必需

输入命中敏感词类型，当input_sensitive为true时返回（取值为以下其一1 严重违规2 色情3 广告4 违禁5 谩骂6 暴恐7 其他）

output_sensitive

boolean

输出命中敏感词

必需

output_sensitive_type

integer

必需

输出命中敏感词类型，当output_sensitive为true时返回（取值同input_sensitive_type）

choices

object

所有结果

必需

text

string

文本结果

必需

index

integer

排名

必需

finish_reason

string

必需

结束原因，枚举值stop：API返回了模型生成的完整结果length：模型生成结果超过tokens_to_generate的长度，内容被截断max_output：输入+模型输出内容超过模型能力限制

delta

string

必需

当request.stream为true，处于流式模式下，回复文本通过delta给出（回复文本分批返回，最后一个回复的delta为空，同时会对整体回复做敏感词检测）

usage

object

必需

tokens数使用情况

total_tokens

integer

必需

消耗tokens总数，包括输入和输出；具体计算方式为输入tokens + 最大输出tokens x beam_width。假设beam_width为2，输入tokens为100，输出结果分别为20tokens和30tokens，最终消耗160tokens（模型以token为基本单位来理解输入和输出）

string

必需

调用id（用于在咨询/反馈时帮助定位问题）

base_resp

object

错误状态码和详情

必需

status_code

integer

必需

状态码（1000，未知错误1001，超时1002，触发限流1004，鉴权失败1008，余额不足1013，服务内部错误1027，输出内容错误1039，触发限流2013，输入格式信息不正常）

status_msg

string

错误详情

必需

{
  "created": 0,
  "model": "string",
  "reply": "string",
  "input_sensitive": true,
  "input_sensitive_type": 0,
  "output_sensitive": true,
  "output_sensitive_type": 0,
  "choices": {
    "text": "string",
    "index": 0,
    "finish_reason": "string",
    "delta": "string"
  },
  "usage": {
    "total_tokens": 0
  },
  "id": "string",
  "base_resp": {
    "status_code": 0,
    "status_msg": "string"
  }
}

最后修改时间： 1 年前