当前位置:   article > 正文

Python调用讯飞星火大模型v3.x api接口使用教程_python调用国内免费的大模型接口

python调用国内免费的大模型接口

be576d98f1cc4c8691b7a52f4a5a786d.png

1、获取api接口的ID和key

        这里我们可以获取星火免费赠送的200万个token使用和测试,获取方法如下:

        打卡网站讯飞星火认知大模型-AI大语言模型-星火大模型-科大讯飞 ,登录用户点击免费使用

        

6e64686a4e0946e4a443559a97876c96.png

 1.1 创建应用

       点击购买首次应该会让创建一个应用, 如下图,按要求内容随意填写,然后提交

27a3bfc87b264315a8a9938cdc574236.png

1.2  购买token

        创建完成应用,回去购买,我这里选择个人的(这些都是在完成认证及设置了支付密码的基础)

228c08303c7e46cd8714a2dc02ca51fc.png

1.3 获取 ID和key

        在工单中心这个大模型3.0,页面就是,appid这三个我们会用到

e351f0da2d1d46af81b1d05afc284d7e.png

ba67966417584bbdb68fc8e78c9def54.png

2、 Python调用api

        我的Python版本是在3.8左右的

        创建一个名为SparkApi.py的Python文件,将下面代码粘进去

        下面官方的代码有个坑,就是answer = ""是个全局变量,这个会将所有的提问拼接在一起,不过这个影响不大,就是打印answer的结果不好看,只要我们输入时text列表清除历史输入,token还是不带历史

  1. import _thread as thread
  2. import base64
  3. import datetime
  4. import hashlib
  5. import hmac
  6. import json
  7. from urllib.parse import urlparse
  8. import ssl
  9. from datetime import datetime
  10. from time import mktime
  11. from urllib.parse import urlencode
  12. from wsgiref.handlers import format_date_time
  13. import websocket # 使用websocket_client
  14. answer = ""
  15. class Ws_Param(object):
  16. # 初始化
  17. def __init__(self, APPID, APIKey, APISecret, Spark_url):
  18. self.APPID = APPID
  19. self.APIKey = APIKey
  20. self.APISecret = APISecret
  21. self.host = urlparse(Spark_url).netloc
  22. self.path = urlparse(Spark_url).path
  23. self.Spark_url = Spark_url
  24. # 生成url
  25. def create_url(self):
  26. # 生成RFC1123格式的时间戳
  27. now = datetime.now()
  28. date = format_date_time(mktime(now.timetuple()))
  29. # 拼接字符串
  30. signature_origin = "host: " + self.host + "\n"
  31. signature_origin += "date: " + date + "\n"
  32. signature_origin += "GET " + self.path + " HTTP/1.1"
  33. # 进行hmac-sha256进行加密
  34. signature_sha = hmac.new(self.APISecret.encode('utf-8'), signature_origin.encode('utf-8'),
  35. digestmod=hashlib.sha256).digest()
  36. signature_sha_base64 = base64.b64encode(signature_sha).decode(encoding='utf-8')
  37. authorization_origin = f'api_key="{self.APIKey}", algorithm="hmac-sha256", headers="host date request-line", signature="{signature_sha_base64}"'
  38. authorization = base64.b64encode(authorization_origin.encode('utf-8')).decode(encoding='utf-8')
  39. # 将请求的鉴权参数组合为字典
  40. v = {
  41. "authorization": authorization,
  42. "date": date,
  43. "host": self.host
  44. }
  45. # 拼接鉴权参数,生成url
  46. url = self.Spark_url + '?' + urlencode(v)
  47. # 此处打印出建立连接时候的url,参考本demo的时候可取消上方打印的注释,比对相同参数时生成的url与自己代码生成的url是否一致
  48. return url
  49. # 收到websocket错误的处理
  50. def on_error(ws, error):
  51. print("### error:", error)
  52. # 收到websocket关闭的处理
  53. def on_close(ws,one,two):
  54. print(" ")
  55. # 收到websocket连接建立的处理
  56. def on_open(ws):
  57. thread.start_new_thread(run, (ws,))
  58. def run(ws, *args):
  59. data = json.dumps(gen_params(appid=ws.appid, domain= ws.domain,question=ws.question))
  60. ws.send(data)
  61. # 收到websocket消息的处理
  62. def on_message(ws, message):
  63. # print(message)
  64. data = json.loads(message)
  65. code = data['header']['code']
  66. if code != 0:
  67. print(f'请求错误: {code}, {data}')
  68. ws.close()
  69. else:
  70. choices = data["payload"]["choices"]
  71. status = choices["status"]
  72. content = choices["text"][0]["content"]
  73. print(content,end ="")
  74. global answer
  75. answer += content
  76. # print(1)
  77. if status == 2:
  78. ws.close()
  79. def gen_params(appid, domain,question):
  80. """
  81. 通过appid和用户的提问来生成请参数
  82. """
  83. data = {
  84. "header": {
  85. "app_id": appid,
  86. "uid": "1234"
  87. },
  88. "parameter": {
  89. "chat": {
  90. "domain": domain,
  91. "temperature": 0.5,
  92. "max_tokens": 2048
  93. }
  94. },
  95. "payload": {
  96. "message": {
  97. "text": question
  98. }
  99. }
  100. }
  101. return data
  102. def main(appid, api_key, api_secret, Spark_url,domain, question):
  103. wsParam = Ws_Param(appid, api_key, api_secret, Spark_url)
  104. websocket.enableTrace(False)
  105. wsUrl = wsParam.create_url()
  106. ws = websocket.WebSocketApp(wsUrl, on_message=on_message, on_error=on_error, on_close=on_close, on_open=on_open)
  107. ws.appid = appid
  108. ws.question = question
  109. ws.domain = domain
  110. ws.run_forever(sslopt={"cert_reqs": ssl.CERT_NONE})

 在随便建一个py文件,将下面代码粘进去,这个是调用客户端,上面文件是服务端

  1. import SparkApi
  2. #以下密钥信息从控制台获取
  3. appid = "XXXXXXXX" #填写控制台中获取的 APPID 信息
  4. api_secret = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" #填写控制台中获取的 APISecret 信息
  5. api_key ="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" #填写控制台中获取的 APIKey 信息
  6. domain = "generalv3" # v3版本
  7. #云端环境的服务地址
  8. Spark_url = "ws://spark-api.xf-yun.com/v3.1/chat" # v3环境的地址("wss://spark-api.xf-yun.com/v3.1/chat)
  9. text =[]
  10. # length = 0
  11. def getText(role,content):
  12. jsoncon = {}
  13. jsoncon["role"] = role
  14. jsoncon["content"] = content
  15. text.append(jsoncon)
  16. return text
  17. def getlength(text):
  18. length = 0
  19. for content in text:
  20. temp = content["content"]
  21. leng = len(temp)
  22. length += leng
  23. return length
  24. def checklen(text):
  25. while (getlength(text) > 8000):
  26. del text[0]
  27. return text
  28. if __name__ == '__main__':
  29. text.clear
  30. while(1):
  31. Input = input("\n" +"我:")
  32. question = checklen(getText("user",Input))
  33. SparkApi.answer =""
  34. print("星火:",end = "")
  35. SparkApi.main(appid,api_key,api_secret,Spark_url,domain,question)
  36. getText("assistant",SparkApi.answer)
  37. # print(str(text))

        这里就需要把刚才控制台的信息替换掉那些xxxx

        ps:这里就是一个python的简易问答,如果想掉用接口,在这个调用文件里加一个调用函数

  1. def spark_api(question):
  2. """
  3. :param question:
  4. :return:
  5. """
  6. question = checklen(getText("user",question))
  7. SparkApi.answer =""
  8. SparkApi.main(appid,api_key,api_secret,Spark_url,domain,question)
  9. text.clear()
  10. return SparkApi.answer

        建议在使用接口函数调用是加上text.clear(),清除历史对话,否则在一个长的连接调用时历史的token会加越来越长,十分消耗token,不需要历史的建议clear

3 、应用分享

        最近作者在做项目是使用到了api辅助数据处理,其中发现在在提示词中加入一个历史对话可能会让结果更标准。下面是测试样例:

        

  1. def getText(role,content):
  2. jsoncon = {}
  3. history_put = """['工程','货物',]\n请从上面选项中选择一个属于下面文本的分类\n左侧边坡宣传标语
  4. ,结果只输出1,2 ,如果都不属于输出0
  5. """
  6. text.append({'role':'user','content':history_put })
  7. text.append({'role': 'assistant', 'content': '0'})
  8. jsoncon["role"] = role
  9. jsoncon["content"] = content
  10. text.append(jsoncon)
  11. return text

         上面代码是作者在函数中加入一串历史对话,这种思路就是每次调用都是一次历史和本次调用,这样在输出的结果上大部分都是一致的。在我测试7000条数据中仅有10条是有解释性话术。

4、bug问题

bug:如下图:

这个是缺少包安装这个即可:websocket-client==1.4.2

41e5ebaf642045cdab2f4008e29ae2aa.png

如下图:

这个我认为是spark_url="ws(s)://spark-api.xf-yun.com/v3.1/chat"  # 错误案例

正确的spark_url="wss://spark-api.xf-yun.com/v3.1/chat" 或者ws://spark-api.xf-yun.com/v3.1/chat

5365771d336a48559a516fbf563f34be.png

5、v3.5最新版接口新增功能补充

(1) 接口参数:对应的domain参数为generalv3.5  ,ws地址3.1改成3.5

(2)system:设置对话背景或者模型角色

        如果想获取结合上下文的回答,需要开发者每次将历史问答信息一起传给服务端,如下示例
        注意:text里面的所有content内容加一起的tokens需要控制在8192以内,开发者如有较长对话需求,需要适当裁剪历史信息。

使用方法--> 旧版本传入请求数据时列表中只有usr和assistant这两个字典数据,现在要是使用system,只需要在usr前加入提示语字典如下图。

        也就是在上文应用分享中 getText函数,text.append(                   {"role":"system","content":"你现在扮演李白,你豪情万丈,狂放不羁;接下来请用李白的口吻和用户对话。"} )后面每次调用接口都是自带system

  1. # 参数构造示例如下
  2. {
  3. "header": {
  4. "app_id": "12345",
  5. "uid": "12345"
  6. },
  7. "parameter": {
  8. "chat": {
  9. "domain": "generalv3.5",
  10. "temperature": 0.5,
  11. "max_tokens": 1024,
  12. }
  13. },
  14. "payload": {
  15. "message": {
  16. # 如果想获取结合上下文的回答,需要开发者每次将历史问答信息一起传给服务端,如下示例
  17. # 注意:text里面的所有content内容加一起的tokens需要控制在8192以内,开发者如有较长对话需求,需要适当裁剪历史信息
  18. "text": [
  19. {"role":"system","content":"你现在扮演李白,你豪情万丈,狂放不羁;接下来请用李白的口吻和用户对话。"} #设置对话背景或者模型角色
  20. {"role": "user", "content": "你是谁"} # 用户的历史问题
  21. {"role": "assistant", "content": "....."} # AI的历史回答结果
  22. # ....... 省略的历史对话
  23. {"role": "user", "content": "你会做什么"} # 最新的一条问题,如无需上下文,可只传最新一条问题
  24. ]
  25. }
  26. }
  27. }

(3)了functions.text字段:用于方法的注册

  1. # 参数构造示例如下,仅在原本生成的基础上,增加了functions.text字段,用于方法的注册
  2. {
  3. "header": {
  4. "app_id": appid,
  5. "uid": "1234"
  6. },
  7. "parameter": {
  8. "chat": {
  9. "domain": domain,
  10. "random_threshold": 0.5,
  11. "max_tokens": 2048,
  12. "auditing": "default"
  13. }
  14. },
  15. "payload": {
  16. "message": {
  17. "text": [
  18. {"role": "user", "content": ""} # 用户的提问
  19. ]
  20. },
  21. "functions": {
  22. "text": [
  23. {
  24. "name": "天气查询",
  25. "description": "天气插件可以提供天气相关信息。你可以提供指定的地点信息、指定的时间点或者时间段信息,来检索诗词库,精准检索到天气信息。",
  26. "parameters": {
  27. "type": "object",
  28. "properties": {
  29. "location": {
  30. "type": "string",
  31. "description": "地点,比如北京。"
  32. },
  33. "date": {
  34. "type": "string",
  35. "description": "日期。"
  36. }
  37. },
  38. "required": [
  39. "location"
  40. ]
  41. }
  42. },
  43. {
  44. "name": "税率查询",
  45. "description": "税率查询可以查询某个地方的个人所得税率情况。你可以提供指定的地点信息、指定的时间点,精准检索到所得税率。",
  46. "parameters": {
  47. "type": "object",
  48. "properties": {
  49. "location": {
  50. "type": "string",
  51. "description": "地点,比如北京。"
  52. },
  53. "date": {
  54. "type": "string",
  55. "description": "日期。"
  56. }
  57. },
  58. "required": [
  59. "location"
  60. ]
  61. }
  62. }
  63. ]
  64. }
  65. }
  66. }

     6、参数说明

项目地址:

https://github.com/liukangjia666/spark_demo

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/IT小白/article/detail/150031
推荐阅读
相关标签
  

闽ICP备14008679号