API 安全策略和基础指南
一文快速了解如何调用天工API接口
2024-07-03
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 requests
import time
import hashlib
import json
url = 'https://api-maas.singularity-ai.com/sky-work/api/v1/chat'
app_key = 'YOUR_APP_KEY' # 这里需要替换你的APIKey
app_secret = 'YOUR_APP_SECRET' # 这里需要替换你的APISecret
timestamp = str(int(time.time()))
sign_content = app_key + app_secret + timestamp
sign_result = hashlib.md5(sign_content.encode('utf-8')).hexdigest()
# 设置请求头，请求的数据格式为json
headers={
"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文章!
同话题下的热门内容