API 安全策略和基礎(chǔ)指南
1、了解了天工API的相關(guān)信息后，來到服務(wù)商官網(wǎng)。在使用天工API之前，你需要注冊一個賬號。
2、在個人中心進行實名認證
注冊完賬號，接下來就是獲取API密鑰了。在個人中心的賬戶管理->API keys點擊查看完整秘鑰
有了密鑰，我們就可以開始調(diào)用天工API了。
首先要導入http請求庫，可以使用以下命令安裝：
pip install requests而后直接發(fā)起請求
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()
# 設(shè)置請求頭，請求的數(shù)據(jù)格式為json
headers={
"app_key": app_key,
"timestamp": timestamp,
"sign": sign_result,
"Content-Type": "application/json",
}
# 設(shè)置請求URL和參數(shù)
data = {
"messages": [
{"role": "user", "content": "天空為什么是藍色的？"}
],
"intent": "" # 用于強制指定意圖，默認為空將進行意圖識別判定是否搜索增強，取值 'chat'則不走搜索增強
}
# 發(fā)起請求并獲取響應(yīng)
response = requests.post(url, headers=headers, json=data, stream=True)
# 處理響應(yīng)流
for line in response.iter_lines():
if line:
# 處理接收到的數(shù)據(jù)
print(line.decode('utf-8'))天工API通常使用HTTP/HTTPS協(xié)議，這也是目前最常見、最安全的網(wǎng)絡(luò)通信方式。請求和響應(yīng)的數(shù)據(jù)格式大多是JSON，這種格式既簡潔又易讀，特別適合前后端的數(shù)據(jù)交換。
例如，剛才的API返回的數(shù)據(jù)是這樣的：
// target 為 update，是一個中間狀態(tài)，后面會繼續(xù)更新
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 說明這一條為最終結(jié)果內(nèi)容
// 全量返回情況下 text 為大模型輸出的全部內(nèi)容
// 增量返回情況下 text 為空
data: {
"type": 1,
"card_type": "markdown",
"target": "finish",
"arguments": [
{
"messages": [
{
"text": "你好！你搜索的是\"hi\"，以下是相關(guān)的搜索結(jié)果：1. \"Hi跑、健力多HIGHFLEX韌性啟程重跑絲綢路，探尋亞洲喝彩亞運\" [1]：該文章介紹了由Hi跑主辦、健力多HIGHFLEX協(xié)辦的【韌性跑世界】“韌性向前,探尋亞洲”活動，旨在通過跑步探尋廣闊壯麗的亞洲，同時呼吁全民關(guān)注健康體魄、為亞運會加油助威。2. \"hi in Simplified Chinese - Cambridge Dictionary\" [2]：該頁面介紹了hi這個詞在簡體中文中的意思，通常作為熟人間的問候語使用。3. \"Hi nova 11評測：強力的能耗比與卓越的體驗\" [3]：該評測報告介紹了Hi nova 11的強大視頻解碼能力和良好的觀影體驗。4. \"hi是什么意思_hi的翻譯_音標_讀音_用法_例句_愛詞霸在線詞典\" [4]：該在線詞典提供了hi這個詞的中文意思、用法講解、讀音、例句等英語服務(wù)。5. \"外觀類似、同店售賣，消費者吐槽想買華為nova錯買了Hi nova\" [5]：該文章介紹了消費者對于外觀相似的Hi nova手機和華為nova手機混淆的情況，強調(diào)它們是不同的品牌。6. \"hi中文(繁體)翻譯：劍橋詞典 - Cambridge Dictionary\" [6]：該頁面提供了hi這個詞在繁體中文中的意思，通常作為熟人間的問候語使用。7. \"Hi貴安｜貴安煙火氣，感受新活力！網(wǎng)絡(luò)達人帶你體驗美食貴安\" [7]：該文章介紹了貴安新區(qū)的美食和風景，表達了網(wǎng)絡(luò)達人通過記錄美食和風景來推廣貴安新區(qū)的旅游文化。8. \"在英文郵件開頭用 Hello 和 Hi 哪個更正式？ - 知乎\" [8]：該知乎回答介紹了在英文郵件開頭，使用\"Hello\"和\"Hi\"都可以，但\"Dear\"是更正式的說法，對于不熟悉的人可以使用\"Hi\"或\"Hello\"。請注意，以上內(nèi)容來自網(wǎng)絡(luò)搜索結(jié)果，在回答問題時我們需要以網(wǎng)絡(luò)搜索結(jié)果為準。",
"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"
}天工大模型，作為國內(nèi)首款對標ChatGPT的語言大模型，具備一系列先進功能，能夠理解和生成高質(zhì)量的自然語言文本，包括但不限于對話、問答、文本摘要、翻譯等。能夠準確回答各種領(lǐng)域的問題，包括專業(yè)知識、日常生活常識等。能夠根據(jù)用戶需求，生成文章、故事、詩歌、郵件等內(nèi)容。依托于先進的自然語言理解和生成技術(shù)，提供接近人類水平的交流體驗。廣泛應(yīng)用于教育、娛樂、商業(yè)咨詢、技術(shù)研發(fā)等多個領(lǐng)域。如通過智能問答和個性化學習資源推薦，提升在線教育質(zhì)量、在軟件開發(fā)過程中提供代碼建議、文檔自動生成等支持。
天工API是一個非常實用的工具，能夠大大簡化我們的開發(fā)工作。無論是數(shù)據(jù)獲取、分析，還是功能實現(xiàn)，它都提供了強有力的支持。如果需要其他類型的API，可以訪問API HUB查看更多！