3. 注冊(cè)賬號(hào)

1、了解了天工API的相關(guān)信息后，來(lái)到服務(wù)商官網(wǎng)。在使用天工API之前，你需要注冊(cè)一個(gè)賬號(hào)。

2、在個(gè)人中心進(jìn)行實(shí)名認(rèn)證

4. 創(chuàng)建密鑰

注冊(cè)完賬號(hào)，接下來(lái)就是獲取API密鑰了。在個(gè)人中心的賬戶(hù)管理->API keys點(diǎn)擊查看完整秘鑰

5. 天工API調(diào)用過(guò)程

有了密鑰，我們就可以開(kāi)始調(diào)用天工API了。

首先要導(dǎo)入http請(qǐng)求庫(kù)，可以使用以下命令安裝：

pip install requests

而后直接發(fā)起請(qǐng)求

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è)置請(qǐng)求頭，請(qǐng)求的數(shù)據(jù)格式為json

headers={

   "app_key": app_key,

   "timestamp": timestamp,

   "sign": sign_result,

   "Content-Type": "application/json",

}



# 設(shè)置請(qǐng)求URL和參數(shù)

data = {

   "messages": [

      {"role": "user", "content": "天空為什么是藍(lán)色的？"}

   ],

   "intent": "" # 用于強(qiáng)制指定意圖，默認(rèn)為空將進(jìn)行意圖識(shí)別判定是否搜索增強(qiáng)，取值 'chat'則不走搜索增強(qiáng)

}



# 發(fā)起請(qǐng)求并獲取響應(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'))

6. 天工API的協(xié)議和格式

天工API通常使用HTTP/HTTPS協(xié)議，這也是目前最常見(jiàn)、最安全的網(wǎng)絡(luò)通信方式。請(qǐng)求和響應(yīng)的數(shù)據(jù)格式大多是JSON，這種格式既簡(jiǎn)潔又易讀，特別適合前后端的數(shù)據(jù)交換。

例如，剛才的API返回的數(shù)據(jù)是這樣的：

// target 為 update，是一個(gè)中間狀態(tài)，后面會(huì)繼續(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 說(shuō)明這一條為最終結(jié)果內(nèi)容

// 全量返回情況下 text 為大模型輸出的全部?jī)?nèi)容

// 增量返回情況下 text 為空

data: {

    "type": 1,

    "card_type": "markdown",

    "target": "finish",

    "arguments": [

        {

            "messages": [

                {

                    "text": "你好！你搜索的是\"hi\"，以下是相關(guān)的搜索結(jié)果：1. \"Hi跑、健力多HIGHFLEX韌性啟程重跑絲綢路，探尋亞洲喝彩亞運(yùn)\" [1]：該文章介紹了由Hi跑主辦、健力多HIGHFLEX協(xié)辦的【韌性跑世界】“韌性向前,探尋亞洲”活動(dòng)，旨在通過(guò)跑步探尋廣闊壯麗的亞洲，同時(shí)呼吁全民關(guān)注健康體魄、為亞運(yùn)會(huì)加油助威。2. \"hi in Simplified Chinese - Cambridge Dictionary\" [2]：該頁(yè)面介紹了hi這個(gè)詞在簡(jiǎn)體中文中的意思，通常作為熟人間的問(wèn)候語(yǔ)使用。3. \"Hi nova 11評(píng)測(cè)：強(qiáng)力的能耗比與卓越的體驗(yàn)\" [3]：該評(píng)測(cè)報(bào)告介紹了Hi nova 11的強(qiáng)大視頻解碼能力和良好的觀影體驗(yàn)。4. \"hi是什么意思_hi的翻譯_音標(biāo)_讀音_用法_例句_愛(ài)詞霸在線詞典\" [4]：該在線詞典提供了hi這個(gè)詞的中文意思、用法講解、讀音、例句等英語(yǔ)服務(wù)。5. \"外觀類(lèi)似、同店售賣(mài)，消費(fèi)者吐槽想買(mǎi)華為nova錯(cuò)買(mǎi)了Hi nova\" [5]：該文章介紹了消費(fèi)者對(duì)于外觀相似的Hi nova手機(jī)和華為nova手機(jī)混淆的情況，強(qiáng)調(diào)它們是不同的品牌。6. \"hi中文(繁體)翻譯：劍橋詞典 - Cambridge Dictionary\" [6]：該頁(yè)面提供了hi這個(gè)詞在繁體中文中的意思，通常作為熟人間的問(wèn)候語(yǔ)使用。7. \"Hi貴安｜貴安煙火氣，感受新活力！網(wǎng)絡(luò)達(dá)人帶你體驗(yàn)美食貴安\" [7]：該文章介紹了貴安新區(qū)的美食和風(fēng)景，表達(dá)了網(wǎng)絡(luò)達(dá)人通過(guò)記錄美食和風(fēng)景來(lái)推廣貴安新區(qū)的旅游文化。8. \"在英文郵件開(kāi)頭用 Hello 和 Hi 哪個(gè)更正式？ - 知乎\" [8]：該知乎回答介紹了在英文郵件開(kāi)頭，使用\"Hello\"和\"Hi\"都可以，但\"Dear\"是更正式的說(shuō)法，對(duì)于不熟悉的人可以使用\"Hi\"或\"Hello\"。請(qǐng)注意，以上內(nèi)容來(lái)自網(wǎng)絡(luò)搜索結(jié)果，在回答問(wèn)題時(shí)我們需要以網(wǎng)絡(luò)搜索結(jié)果為準(zhǔn)。",

                    "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的功能、特點(diǎn)及應(yīng)用場(chǎng)景

天工大模型，作為國(guó)內(nèi)首款對(duì)標(biāo)ChatGPT的語(yǔ)言大模型，具備一系列先進(jìn)功能，能夠理解和生成高質(zhì)量的自然語(yǔ)言文本，包括但不限于對(duì)話(huà)、問(wèn)答、文本摘要、翻譯等。能夠準(zhǔn)確回答各種領(lǐng)域的問(wèn)題，包括專(zhuān)業(yè)知識(shí)、日常生活常識(shí)等。能夠根據(jù)用戶(hù)需求，生成文章、故事、詩(shī)歌、郵件等內(nèi)容。依托于先進(jìn)的自然語(yǔ)言理解和生成技術(shù)，提供接近人類(lèi)水平的交流體驗(yàn)。廣泛應(yīng)用于教育、娛樂(lè)、商業(yè)咨詢(xún)、技術(shù)研發(fā)等多個(gè)領(lǐng)域。如通過(guò)智能問(wèn)答和個(gè)性化學(xué)習(xí)資源推薦，提升在線教育質(zhì)量、在軟件開(kāi)發(fā)過(guò)程中提供代碼建議、文檔自動(dòng)生成等支持。

8. 總結(jié)

天工API是一個(gè)非常實(shí)用的工具，能夠大大簡(jiǎn)化我們的開(kāi)發(fā)工作。無(wú)論是數(shù)據(jù)獲取、分析，還是功能實(shí)現(xiàn)，它都提供了強(qiáng)有力的支持。如果需要其他類(lèi)型的API，可以訪問(wèn)API HUB查看更多！

上一篇：

初學(xué)者必看:RPC詳解

下一篇：

一文匯總好用的企業(yè)工商信息API接口
#你可能也喜歡這些API文章!

我們有何不同？

API服務(wù)商零注冊(cè)

多API并行試用

數(shù)據(jù)驅(qū)動(dòng)選型，提升決策效率

查看全部API→
??

熱門(mén)場(chǎng)景實(shí)測(cè)，選對(duì)API

#AI文本生成大模型API

對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力

25個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)

#AI深度推理大模型API

對(duì)比大模型API的邏輯推理準(zhǔn)確性、分析深度、可視化建議合理性

10個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)