一、简介
讯飞开放平台作为开放的智能交互技术服务平台,致力于为开发者打造一站式智能人机交互解决方案。用户可通过互联网、移动互联网,使用任何设备、在任何时间、任何地点,随时随地享受讯飞开放平台提供的“听、说、读、写……”等全方位的人工智能服务。目前,开放平台以“云+端”的形式向开发者提供语音合成、语音识别、语音唤醒、语义理解、人脸识别等多项服务。
国内外企业、中小创业团队和个人开发者,均可在讯飞开放平台直接体验先进的语音技术,并简单快速集成到产品中,让产品具备“能听会说会思考会预测”的功能。
二、产品优势
- 快速响应,高效处理采用流式的接口设计,首帧响应最快可达毫秒级。借助高效算法与架构,能在极短时间处理大量用户请求
- 多元场景,持续进化提供包括语言理解、知识问答、代码编写、逻辑推理、数学解题等多元能力,持续从海量数据和知识中学习与进化
- 灵活应用,个性定制提供丰富的参数设置,可以实现个性化的模型体验。针对企业级的定制化需求,可以提供专属的模型解决方案
- 服务稳定,安全可靠云服务达到等保三级标准,采用千亿级流量的公有云架构,结合数据加密与访问控制等多重手段确保用户隐私安全
三、产品价格
完成个人认证即可免费试用,完成企业认证即可免费试用企业包。两者Token值不同,个人版200万Token,企业版500万Token。(1tokens 约等于1.5个中文汉字 或者 0.8个英文单词)(免费版本只能进行文本对话)
企业认证需要的材料
个人认证需要的材料
四、Web API接口说明
- 必须符合 websocket 协议规范(rfc6455)。
- websocket握手成功后用户在60秒内没有发送请求数据,服务侧会主动断开。
- 本接口默认采用短链接的模式,即接口每次将结果完整返回给用户后会主动断开链接,用户在下次发送请求的时候需要重新握手链接。
4.1 请求地址
Tips: 星火大模型API当前有V1.5、V2.0和V3.0三个版本,三个版本独立计量tokens。
传输协议 :ws(s),为提高安全性,强烈推荐wss
星火大模型V1.5请求地址,对应的domain参数为general:
wss://spark-api.xf-yun.com/v1.1/chat
星火大模型V2请求地址,对应的domain参数为generalv2:
wss://spark-api.xf-yun.com/v2.1/chat
星火大模型V3请求地址,对应的domain参数为generalv3:
wss://spark-api.xf-yun.com/v3.1/chat
4.2 接口鉴权
4.2.1 鉴权说明
开发者需要自行先在控制台创建应用,利用应用中提供的appid,APIKey, APISecret进行鉴权,生成最终请求的鉴权url。
(1) 鉴权参数
参数 | 类型 | 必须 | 说明 | 示例 |
host | string | 是 | 请求的主机 | aichat.xf-yun.com(使用时需替换为实际使用的接口地址) |
date | string | 是 | 当前时间戳,采用RFC1123格式,时间偏差需控制在300s内 | Fri, 05 May 2023 10:43:39 GMT |
authorization | string | 是 | base64编码的签名信息 | 参考下方生成方式 |
最终url需要的参数如上,下方以Python为例进行鉴权参数的生成示例,开发者如果使用其它开发语言可以按照相同时间戳和apikey等常量来逐步生成参数和下方示例比对,确保鉴权步骤无误
(2)date参数生成规则
from datetime import datetime
from time import mktime
from wsgiref.handlers import format_date_timecur_time = datetime.now()
date = format_date_time(mktime(cur_time.timetuple()))
假使生成的date和下方使用的date = Fri, 05 May 2023 10:43:39 GMT
(3) authorization参数生成规则
1)到控制台获取APIKey 和APISecret参数
2)利用上方的date动态拼接生成字符串tmp,这里以星火url为例,实际使用需要根据具体的请求url替换host和path。
tmp = "host: " + "spark-api.xf-yun.com" + "\n"
tmp += "date: " + date + "\n"
tmp += "GET " + "/v1.1/chat" + " HTTP/1.1"
"""上方拼接生成的tmp字符串如下
host: spark-api.xf-yun.com
date: Fri, 05 May 2023 10:43:39 GMT
GET /v1.1/chat HTTP/1.1
"""
3)