所有文章 > 日积月累 > 一文快速了解如何调用天工API接口
一文快速了解如何调用天工API接口

一文快速了解如何调用天工API接口

1. 天工API介绍

在现代软件开发中,API应用程序接口)已经成为了实现系统互联和功能扩展的重要工具。天工 API 是一款功能强大的接口,特别适用于复杂对话系统、深度内容创作、以及代码生成等多种场景。与前一版本相比,天工 API 3.0 在搜索能力和信息整合方面进行了显著增强,利用最新的搜索引擎技术,不仅能够快速找到相关信息,还可以智能分析并提供更加精准和丰富的回答。例如,在广告文案创作中,天工 API 可以根据用户提供的简要信息生成创意性文案;在小说写作中,它能够提供情节建议和人物对话;在知识类写作中,API 会整合多源信息提供详细而准确的内容;在代码生成中,天工 API 能够根据需求生成符合规范的代码片段。

那么,如何对接天工API呢?

2. 发现API

可以通过幂简集成API HUB中的“AI技术”分类中查看大量AI相关API,也可以直接搜索“天工API”找到所需的API。

3. 注册账号

1、了解了天工API的相关信息后,来到服务商官网。在使用天工API之前,你需要注册一个账号。

2、在个人中心进行实名认证

4. 创建密钥

注册完账号,接下来就是获取API密钥了。在个人中心的账户管理->API keys点击查看完整秘钥

5. 天工API调用过程

有了密钥,我们就可以开始调用天工API了。

首先要导入http请求库,可以使用以下命令安装:

pip install requests

而后直接发起请求

import requestsimport timeimport hashlibimport jsonurl = 'https://api-maas.singularity-ai.com/sky-work/api/v1/chat'app_key = 'YOUR_APP_KEY'        # 这里需要替换你的APIKeyapp_secret = 'YOUR_APP_SECRET'  # 这里需要替换你的APISecrettimestamp = str(int(time.time()))sign_content = app_key + app_secret + timestampsign_result = hashlib.md5(sign_content.encode('utf-8')).hexdigest()# 设置请求头,请求的数据格式为jsonheaders={   "app_key": app_key,   "timestamp": timestamp,   "sign": sign_result,   "Content-Type": "application/json",}# 设置请求URL和参数data = {   "messages": [      {"role": "user", "content": "天空为什么是蓝色的?"}   ],   "intent": "" # 用于强制指定意图,默认为空将进行意图识别判定是否搜索增强,取值 'chat'则不走搜索增强}# 发起请求并获取响应response = requests.post(url, headers=headers, json=data, stream=True)# 处理响应流for line in response.iter_lines():   if line:      # 处理接收到的数据      print(line.decode('utf-8'))

6. 天工API的协议和格式

天工API通常使用HTTP/HTTPS协议,这也是目前最常见、最安全的网络通信方式。请求和响应的数据格式大多是JSON,这种格式既简洁又易读,特别适合前后端的数据交换。

例如,刚才的API返回的数据是这样的:

// target 为 update,是一个中间状态,后面会继续更新data: {    "type": 1,    "card_type": "markdown",    "target": "update",    "arguments": [        {            "messages": [                {                    "text": "你",                    "author": "bot",                    "createdAt": "",                    "timestamp": "",                    "type": "",                    "cardId": "5161641c-014b-4baa-8aeb-df67a0669c0f",                    "addition": ""                }            ],            "requestId": "eca68c90-e0a8-4b88-ae69-16ac20a877d3"        }    ],    "conversation_id": "1693209867984-NCYZDpN5",    "request_id": "eca68c90-e0a8-4b88-ae69-16ac20a877d3",    "ask_id": "af1f1f20-2d5f-48b0-9592-a23dbcc93027"}// target 为 finish 说明这一条为最终结果内容// 全量返回情况下 text 为大模型输出的全部内容// 增量返回情况下 text 为空data: {    "type": 1,    "card_type": "markdown",    "target": "finish",    "arguments": [        {            "messages": [                {                    "text": "你好!你搜索的是\"hi\",以下是相关的搜索结果:1. \"Hi跑、健力多HIGHFLEX韧性启程重跑丝绸路,探寻亚洲喝彩亚运\" [1]:该文章介绍了由Hi跑主办、健力多HIGHFLEX协办的【韧性跑世界】“韧性向前,探寻亚洲”活动,旨在通过跑步探寻广阔壮丽的亚洲,同时呼吁全民关注健康体魄、为亚运会加油助威。2. \"hi in Simplified Chinese - Cambridge Dictionary\" [2]:该页面介绍了hi这个词在简体中文中的意思,通常作为熟人间的问候语使用。3. \"Hi nova 11评测:强力的能耗比与卓越的体验\" [3]:该评测报告介绍了Hi nova 11的强大视频解码能力和良好的观影体验。4. \"hi是什么意思_hi的翻译_音标_读音_用法_例句_爱词霸在线词典\" [4]:该在线词典提供了hi这个词的中文意思、用法讲解、读音、例句等英语服务。5. \"外观类似、同店售卖,消费者吐槽想买华为nova错买了Hi nova\" [5]:该文章介绍了消费者对于外观相似的Hi nova手机和华为nova手机混淆的情况,强调它们是不同的品牌。6. \"hi中文(繁體)翻譯:劍橋詞典 - Cambridge Dictionary\" [6]:该页面提供了hi这个词在繁体中文中的意思,通常作为熟人间的问候语使用。7. \"Hi贵安|贵安烟火气,感受新活力!网络达人带你体验美食贵安\" [7]:该文章介绍了贵安新区的美食和风景,表达了网络达人通过记录美食和风景来推广贵安新区的旅游文化。8. \"在英文邮件开头用 Hello 和 Hi 哪个更正式? - 知乎\" [8]:该知乎回答介绍了在英文邮件开头,使用\"Hello\"和\"Hi\"都可以,但\"Dear\"是更正式的说法,对于不熟悉的人可以使用\"Hi\"或\"Hello\"。请注意,以上内容来自网络搜索结果,在回答问题时我们需要以网络搜索结果为准。",                    "author": "bot",                    "createdAt": "",                    "timestamp": "",                    "type": "",                    "cardId": "5161641c-014b-4baa-8aeb-df67a0669c0f",                    "addition": ""                }            ],            "requestId": "eca68c90-e0a8-4b88-ae69-16ac20a877d3"        }    ],    "conversation_id": "1693209867984-NCYZDpN5",    "request_id": "eca68c90-e0a8-4b88-ae69-16ac20a877d3",    "ask_id": "af1f1f20-2d5f-48b0-9592-a23dbcc93027"}

7. 天工API的功能、特点及应用场景

天工大模型,作为国内首款对标ChatGPT语言大模型,具备一系列先进功能,能够理解和生成高质量的自然语言文本,包括但不限于对话、问答、文本摘要、翻译等。能够准确回答各种领域的问题,包括专业知识、日常生活常识等。能够根据用户需求,生成文章、故事、诗歌、邮件等内容。依托于先进的自然语言理解和生成技术,提供接近人类水平的交流体验。广泛应用于教育、娱乐、商业咨询、技术研发等多个领域。如通过智能问答和个性化学习资源推荐,提升在线教育质量、在软件开发过程中提供代码建议、文档自动生成等支持。

8. 总结

天工API是一个非常实用的工具,能够大大简化我们的开发工作。无论是数据获取、分析,还是功能实现,它都提供了强有力的支持。如果需要其他类型的API,可以访问API HUB查看更多!

#你可能也喜欢这些API文章!