讯飞星火认知大模型V3.5 python调用 Web API

具体参考 科大讯飞:星火认知大模型Web API文档

1.首先要注册一个 讯飞星火账号，

进行实名认证，并领取免费试用额度。
并进入控制台找到 APPID, APISecret ,APIKey 三个关键信息
（图1）

2. 按照自己的业务需求，翻看相关SDK开发文档， 如图1所示。

3. 星火认知大模型Web API python示例源码文件共两个

• 测试例子：test.py
• 接口请求与接口解析函数：SparkApi.py

星火认知大模型Web API python的示例下载

这里只在 示例的基础上 参考 星火认知大模型Web API文档改为了 星火大模型V3.5版本的请求地址，因为这里申请的是V3.5版本的对话额度。

• 我的本地测试效果如图2（命令行效果）：

（图2）

• 这里的示例代码如下（domain = “generalv3.5” # v3.5版本）：

*接口请求与接口解析函数：SparkApi.py

# 接口请求与接口解析函数：SparkApi.py

import _thread as thread
import base64
import datetime
import hashlib
import hmac
import json
from urllib.parse import urlparse
import ssl
from datetime import datetime
from time import mktime
from urllib.parse import urlencode
from wsgiref.handlers import format_date_time

import websocket  # 使用websocket_client
answer = ""

class Ws_Param(object):
    # 初始化
    def __init__(self, APPID, APIKey, APISecret, Spark_url):
        self.APPID = APPID
        self.APIKey = APIKey
        self.APISecret = APISecret
        self.host = urlparse(Spark_url).netloc
        self.path = urlparse(Spark_url).path
        self.Spark_url = Spark_url

    # 生成url
    def create_url(self):
        # 生成RFC1123格式的时间戳
        now = datetime.now()
        date = format_date_time(mktime(now.timetuple()))

        # 拼接字符串
        signature_origin = "host: " + self.host + "\n"
        signature_origin += "date: " + date + "\n"
        signature_origin += "GET " + self.path + " HTTP/1.1"

        # 进行hmac-sha256进行加密
        signature_sha = hmac.new(self.APISecret.encode('utf-8'), signature_origin.encode('utf-8'),
                                 digestmod=hashlib.sha256).digest()

        signature_sha_base64 = base64.b64encode(signature_sha).decode(encoding='utf-8')

        authorization_origin = f'api_key="{self.APIKey}", algorithm="hmac-sha256", headers="host date request-line", signature="{signature_sha_base64}"'

        authorization = base64.b64encode(authorization_origin.encode('utf-8')).decode(encoding='utf-8')

        # 将请求的鉴权参数组合为字典
        v = {
            "authorization": authorization,
            "date": date,
            "host": self.host
        }
        # 拼接鉴权参数，生成url
        url = self.Spark_url + '?' + urlencode(v)
        # 此处打印出建立连接时候的url,参考本demo的时候可取消上方打印的注释，比对相同参数时生成的url与自己代码生成的url是否一致
        return url

# 收到websocket错误的处理
def on_error(ws, error):
    print("### error:", error)

# 收到websocket关闭的处理
def on_close(ws,one,two):
    print(" ")

# 收到websocket连接建立的处理
def on_open(ws):
    thread.start_new_thread(run, (ws,))

def run(ws, *args):
    data = json.dumps(gen_params(appid=ws.appid, domain= ws.domain,question=ws.question))
    ws.send(data)

# 收到websocket消息的处理
def on_message(ws, message):
    # print(message)
    data = json.loads(message)
    code = data['header']['code']
    if code != 0:
        print(f'请求错误: {code}, {data}')
        ws.close()
    else:
        choices = data["payload"]["choices"]
        status = choices["status"]
        content = choices["text"][0]["content"]
        # print(content,end ="") #持续打印  间断收到的信息
        global answer
        answer += content   #不断将收到的信息拼接到 回复对话
        # print(1)
        if status == 2:     #对话回复的拼接结束
            # print(answer,end ="") #打印完整回复
            ws.close()
            
def gen_params(appid, domain,question):
    """
    通过appid和用户的提问来生成请参数
    """
    data = {
        "header": {
            "app_id": appid,
            "uid": "1234"
        },
        "parameter": {
            "chat": {
                "domain": domain,
                "temperature": 0.5,
                "max_tokens": 2048
            }
        },
        "payload": {
            "message": {
                "text": question
            }
        }
    }
    return data


def main(appid, api_key, api_secret, Spark_url, domain, question):
    # print("星火:")
    wsParam = Ws_Param(appid, api_key, api_secret, Spark_url)
    websocket.enableTrace(False)
    wsUrl = wsParam.create_url()
    ws = websocket.WebSocketApp(wsUrl, on_message=on_message, on_error=on_error, on_close=on_close, on_open=on_open)
    ws.appid = appid
    ws.question = question
    ws.domain = domain
    ws.run_forever(sslopt={"cert_reqs": ssl.CERT_NONE})

*测试例子：test.py

# 测试例子：test.py

import SparkApi

#以下密钥信息从控制台获取
appid = "填写控制台中获取的 APPID 信息"     #填写控制台中获取的 APPID 信息
api_secret = "填写控制台中获取的 APISecret 信息"     #填写控制台中获取的 APISecret 信息
api_key ="填写控制台中获取的 APIKey 信息"         #填写控制台中获取的 APIKey 信息

#用于配置大模型版本，默认“general/generalv2”
# domain = "general"   # v1.5版本
# domain = "generalv2"    # v2.0版本
domain = "generalv3.5"    # v3.5版本
#云端环境的服务地址
# Spark_url = "ws://spark-api.xf-yun.com/v1.1/chat"  # v1.5环境的地址
# Spark_url = "ws://spark-api.xf-yun.com/v2.1/chat"  # v2.0环境的地址
Spark_url = "ws://spark-api.xf-yun.com/v3.5/chat"    # v3.5环境的地址


text =[]
# length = 0

def getText(role,content):
    jsoncon = {}
    jsoncon["role"] = role
    jsoncon["content"] = content
    text.append(jsoncon)
    return text

def getlength(text):
    length = 0
    for content in text:
        temp = content["content"]
        leng = len(temp)
        length += leng
    return length

def checklen(text):
    while (getlength(text) > 8000):
        del text[0]
    return text
    


if __name__ == '__main__':
    text.clear
    charTimes=0
    while(1):
        print("==========\r\n")
        charTimes+=1
        print("---我的提问"+str(charTimes)+"\r\n")
        Input = input("提问:")
        question = checklen(getText("user",Input))

        SparkApi.answer =""
        SparkApi.main(appid,api_key,api_secret,Spark_url,domain,question)

        getText("assistant",SparkApi.answer)
        print("星火:"+ SparkApi.answer, end = "\r\n\n")
        
        print("---text回复"+str(charTimes)+"原JSON内容:\r\n")
        print(text[-2])
        print(text[-1])
        print("==========\r\n")