
掌握ChatGPT插件與自定義GPT
3.實(shí)名認(rèn)證:進(jìn)入平臺(tái)控制臺(tái)的“賬戶中心“-》“實(shí)名認(rèn)證”頁面,點(diǎn)擊【開始個(gè)人認(rèn)證】按鈕,根據(jù)步驟指引填入相關(guān)信息即可完成實(shí)名認(rèn)證。
注意:若需要使用API key,需要完成實(shí)名認(rèn)證。
個(gè)人認(rèn)證
第一步:用戶需要填入真實(shí)姓名以及身份證號(hào),確保準(zhǔn)確無誤。
第二步:上傳一張正臉的人臉照片,確保是本人。
第三步:實(shí)名認(rèn)證服務(wù)會(huì)校驗(yàn)身份證照片和上傳的人臉照片為同一個(gè)人,校驗(yàn)成功即完成實(shí)名認(rèn)證。
企業(yè)認(rèn)證
進(jìn)入平臺(tái)控制臺(tái)的“賬戶中心“-》“實(shí)名認(rèn)證”頁面,點(diǎn)擊【開始企業(yè)認(rèn)證】按鈕,根據(jù)步驟指引填入相關(guān)信息即可完成企業(yè)認(rèn)證。
第一步:選擇組織類型并填寫相關(guān)信息,確保準(zhǔn)確無誤。
第二步:填寫認(rèn)證授權(quán)代表信息,和下載授權(quán)委托書并填寫上傳后方可提交認(rèn)證。
審核時(shí)間預(yù)計(jì)5-7個(gè)工作日完成。
4.查看API key: API訪問管理-》“API Key管理”頁面
在獲取API密鑰后,進(jìn)行可用性測試是確保其正常工作的重要步驟。將$API_KEY
替換成你的 key。以下是使用CURL進(jìn)行測試的一個(gè)案例:
輸入:
curl --location 'https://ai-maas.wair.ac.cn/maas/v1/chat/completions' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "taichu_llm",
"messages": [
{
"role": "user",
"content": "你好"
}
],
"stream": false
}'
輸出:
你將得到一個(gè)JSON格式的響應(yīng),其中包含了詳細(xì)信息,如本次使用的模型名稱、回復(fù)內(nèi)容、token使用數(shù)量、prompt 使用的 tokens 數(shù)量等。
示例輸出:
{
"id": "cmpl-91113f8d8e294790ba6394d47dc5f5ce",
"object": "chat.completion",
"created": 1713521143,
"model": "taichu_llm",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!有什么問題或者需要幫助的地方嗎?我在這里隨時(shí)準(zhǔn)備回答您的問題。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 11,
"total_tokens": 30,
"completion_tokens": 19
}
}
在使用紫東太初 API搭建應(yīng)用時(shí),除了獲取和測試API密鑰外,還需考慮以下因素:
請(qǐng)求地址:https://ai-maas.wair.ac.cn/maas/v1/chat/completions
Header 參數(shù)說明
字段 | 類型 | 必選 | 描述 | 示例值 |
---|---|---|---|---|
Content-Type | string | 是 | 請(qǐng)求類型 | application/json |
Authorization | string | 是 | API Key,格式為 Bearer $ | Bearer ayvs***vufp |
Body 參數(shù)說明
參數(shù)名稱 | 類型 | 是否必填 | 參數(shù)說明 |
---|---|---|---|
model | string | 是 | 所要調(diào)用的模型編碼,模型可選模型 taichu_llm |
messages | list | 是 | 一個(gè)由歷史消息組成的列表,詳細(xì)說明,參照 messages 信息說明 |
stream | bool | 否 | 使用同步調(diào)用時(shí),此參數(shù)應(yīng)當(dāng)設(shè)置為 fasle。表示模型生成完所有內(nèi)容后一次性返回所有內(nèi)容。如果設(shè)置為 true,模型將通過標(biāo)準(zhǔn) Event Stream ,逐塊返回模型生成內(nèi)容。Event Stream 結(jié)束時(shí)會(huì)返回一條data: [DONE]消息。默認(rèn)值為 true |
temperature | float | 否 | 生成過程中的溫度值,取值范圍[0.01,1.00] 閉區(qū)間,默認(rèn)值為 0.8,調(diào)節(jié)最小細(xì)粒度為0.01 |
top_p | float | 否 | 生成過程中的token幾率閾值取值范圍是:(0.0, 1.0) 開區(qū)間,默認(rèn)值為 0.9,調(diào)節(jié)最小細(xì)粒度為0.1 |
max_tokens | int | 否 | 模型輸出最大 tokens,最大輸出為8192,默認(rèn)值為3000 |
tools | list | 否 | 可供模型調(diào)用的工具。詳細(xì)說明,參照 tools參數(shù)說明 |
tool_choice | string | 否 | 用于控制模型是如何選擇要調(diào)用的函數(shù),僅當(dāng)工具類型為function時(shí)補(bǔ)充。默認(rèn)為auto,當(dāng)前僅支持auto |
messages參數(shù)說明
參數(shù)名稱 | 類型 | 是否必填 | 說明 |
---|---|---|---|
role | string | 是 | system:系統(tǒng),user:用戶,assistant:模型,tool:工具調(diào)用 |
content | string | 是 | role=system 時(shí)為系統(tǒng)提示信息,role=user 時(shí)為用戶輸入信息,role=assistant 時(shí)為模型返回信息,role=tool 時(shí)為工具調(diào)用返回信息 |
返回參數(shù)說明
參數(shù)名稱 | 子參數(shù)名稱 | 類型 | 說明 |
---|---|---|---|
id | string | 本次請(qǐng)求唯一標(biāo)識(shí) | |
model | string | 本次使用的模型名稱 | |
choices | list | ||
messages | object | 同步響應(yīng)時(shí),返回該字段,詳細(xì)說明見 messages 和 delta 參數(shù)說明 | |
delta | object | 流式響應(yīng)時(shí),返回該字段,詳細(xì)說明見 messages 和 delta 參數(shù)說明 | |
finish_reason | string | stop: 表示模型輸出結(jié)束length: 表示模型輸出長度達(dá)到max_tokens tool_calls: 表示模型命中函數(shù) content_filter: 表示模型輸出被安全審核攔截,針對(duì)此類內(nèi)容,請(qǐng)用戶自行判斷并決定是否撤回已公開的內(nèi)容。 | |
usage | object | token使用數(shù)量 | |
completion_tokens | int | 內(nèi)容生成的 tokens 數(shù)量 | |
prompt_tokens | int | prompt 使用的 tokens 數(shù)量 | |
total_tokens | int | 總 tokens 用量 |
請(qǐng)求地址:https://ai-maas.wair.ac.cn/maas/v1/model_api/invoke
接口請(qǐng)求參數(shù)
參數(shù)名稱 | 類型 | 是否必填 | 說明 |
---|---|---|---|
api_key | string | 是 | apikey管理頁面獲取 |
model_code | string | 是 | 模型code,此處為taichu_vqa |
question | string | 是 | 用戶輸入信息 |
picture | string | 是 | 圖片base64編碼 |
context | string | 否 | 上下文信息,首次請(qǐng)求不需要帶,后續(xù)請(qǐng)求使用接口返回的context值,當(dāng)picture發(fā)生變化時(shí),context需要重置為空 |
temperature | float | 否 | 生成過程中的溫度值,取值范圍[0.01,1.00] 閉區(qū)間,默認(rèn)值為 1.0,調(diào)節(jié)最小細(xì)粒度為0.01 |
top_p | float | 否 | 生成過程中的token幾率閾值取值范圍是:(0.0, 1.0) 開區(qū)間,默認(rèn)值為 0.9,調(diào)節(jié)最小細(xì)粒度為0.1 |
repetition_penalty | float | 否 | 生成過程中的懲罰值取值范圍是:(1.0, 2.0) 開區(qū)間,默認(rèn)值為 1.0,調(diào)節(jié)最小細(xì)粒度為0.1 |
返回參數(shù)說明
參數(shù)名稱 | 二級(jí)參數(shù)名稱 | 類型 | 說明 |
---|---|---|---|
code | int | 錯(cuò)誤碼,非0異常 | |
msg | string | 錯(cuò)誤信息 | |
data | object | ||
content | string | 返回的文本內(nèi)容 | |
context | string | 問答上下文,后續(xù)請(qǐng)求使用該值帶入?yún)?shù) |
HTTP 返回碼 | 錯(cuò)誤message |
---|---|
400 | 參數(shù)錯(cuò)誤: |
401 | apikey缺失 |
401 | apikey不存在 |
403 | apikey被禁用 |
403 | 請(qǐng)先完成實(shí)名認(rèn)證 |
403 | apikey無權(quán)限調(diào)用該模型 |
403 | 當(dāng)前用戶無權(quán)限調(diào)用該模型 |
403 | 余額不足,請(qǐng)及時(shí)充值 |
403 | 非常抱歉,這個(gè)問題我暫時(shí)無法回答,如果您有其他的問題咨詢,我非常樂意幫助你。 |
500 | 系統(tǒng)異常,請(qǐng)聯(lián)系技術(shù)支持 |
503 | 服務(wù)繁忙,請(qǐng)稍后再試 |
503 | 內(nèi)部模型服務(wù)鑒權(quán)失敗 |
503 | 內(nèi)部模型服務(wù)不存在 |
503 | 內(nèi)部模型服務(wù)禁止預(yù)測 |
在申請(qǐng)和使用 紫東太初 API密鑰過程中,你可能會(huì)遇到以下常見問題:
1. 如何查看API使用情況和調(diào)用記錄?
用戶可以在賬戶中心>API訪問管理>用量統(tǒng)計(jì) 查看API的使用情況,包括調(diào)用量、最近調(diào)用時(shí)間這些統(tǒng)計(jì)信息。這些數(shù)據(jù)有助于用戶監(jiān)控API。
2. 遇到API調(diào)用錯(cuò)誤如何處理?
如果調(diào)用API時(shí)遇到錯(cuò)誤,建議首先檢查請(qǐng)求參數(shù)和密鑰的正確性。API文檔中提供了常見錯(cuò)誤代碼和對(duì)應(yīng)解決方案。如問題仍未解決,可聯(lián)系技術(shù)支持獲取幫助。
3. API是怎么收費(fèi)的?
紫東太初大模型開放平臺(tái) API 的計(jì)費(fèi)單元是 token,一般而言,在中文文本中,1 個(gè) token 大約對(duì)應(yīng) 1-2 個(gè)漢字;在英文文本中,1 個(gè) token 大約對(duì)應(yīng) 3-4 個(gè)字母。紫東太初大模型開放平臺(tái) API 根據(jù)模型輸入和輸出的總 token 數(shù)量進(jìn)行計(jì)量計(jì)費(fèi)。
在獲得紫東太初 API密鑰之后,即可開啟API接口對(duì)接,本文整理了多篇開發(fā)者使用紫東太初 API的案例,幫助讀者更有效地使用紫東太初 API:
問題1: 什么是冪簡集成平臺(tái)?
冪簡集成是蜜堂有信在2023年打造的一款SAAS產(chǎn)品,建設(shè)著國內(nèi)最全的API平臺(tái),為開發(fā)者提供全面、高效、易用的API集成管理方案,一站搜索、試用、集成國內(nèi)和國外API。讓用戶在AI時(shí)代全方位接入互聯(lián)網(wǎng),用API連接一切服務(wù)和算力,實(shí)現(xiàn)價(jià)值倍增。
問題2:如何找到紫東太初 API
冪簡API平臺(tái)可以通過以下兩種方式找到所需API:通過關(guān)鍵詞搜索API(例如,輸入’紫東太初 API‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁進(jìn)入尋找。
問題3:紫東太初 API的替代品有哪些?
市場上存在免費(fèi)、付費(fèi)兩種替代者
例如
Perplexity AI大模型API接口介紹及對(duì)接
豆包大模型API接口介紹及對(duì)接-字節(jié)跳動(dòng)
更多競品可以在紫東太初 API開放平臺(tái)找到。
本文為開發(fā)者提供了清晰的指南,涵蓋了紫東太初 API 密鑰的申請(qǐng)、測試及實(shí)際應(yīng)用中的關(guān)鍵注意事項(xiàng)。通過這些步驟和實(shí)用的示例,用戶能夠快速上手紫東太初 API,并充分利用其豐富的功能。在接入和使用的過程中,常見問題解答和錯(cuò)誤處理部分也將幫助用戶更順利地進(jìn)行開發(fā)集成,為應(yīng)用提供強(qiáng)大的智能支持。
對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力
一鍵對(duì)比試用API 限時(shí)免費(fèi)