2. 開通DashScope

您需要在開通DashScope后,才可以獲得API-KEY。開通DashScope請參考以下步驟:

  1. 訪問DashScope管理控制臺:前往控制臺。image.png
  2. 在控制臺“總覽”頁下,單擊去開通。下載.jpeg
  3. 閱讀服務(wù)協(xié)議,確認(rèn)無誤后單擊立即開通。image..png

3. 獲取API-KEY

您可以按照以下步驟獲取DashScope的API-KEY。

  1. 訪問DashScope管理控制臺API-KEY管理頁面:前往API-KEY管理,單擊創(chuàng)建新的API-KEY。API-KEY.jpg
  2. 系統(tǒng)創(chuàng)建生成API-KEY,并在彈出的對話框中展示,您可以單擊復(fù)制按鈕將API-KEY的內(nèi)容復(fù)制保存。查看API-KEY00.jpg
  3. 復(fù)制并在安全的地方保存API-KEY后,單擊我已保存,關(guān)閉。此次創(chuàng)建的API-KEY可立即用于調(diào)用DashScopeAPI,對API-KEY的后續(xù)操作均可在當(dāng)前的API-KEY管理頁面進(jìn)行。API-KEY.jpg

4. 配置API

在您獲取到API-KEY后,可在您的業(yè)務(wù)代碼中配置API-KEY值來使用DashScope的模型服務(wù)。您可以通過以下兩種方式進(jìn)行配置。

方式一:通過環(huán)境變量設(shè)置API-KEY(推薦)

環(huán)境變量是操作系統(tǒng)中用于存儲有關(guān)系統(tǒng)環(huán)境的信息的變量。您可以通過環(huán)境變量來配置API-KEY,這樣即使您的代碼庫被公開,API-KEY也不會泄漏。您可以根據(jù)您的操作系統(tǒng)與使用場景來確定添加API-KEY到環(huán)境變量中的方法。

方式一:添加臨時性環(huán)境變量

如果您僅需要在當(dāng)前會話中添加并使用臨時性環(huán)境變量,可以運(yùn)行以下命令:

# 用您的 API-KEY 代替 YOUR_DASHSCOPE_API_KEY
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

您可以在當(dāng)前會話運(yùn)行以下命令檢查環(huán)境變量是否生效:

echo $DASHSCOPE_API_KEY
方式二:對當(dāng)前用戶添加永久性環(huán)境變量

如果您需要對當(dāng)前用戶添加永久性環(huán)境變量,使得在該用戶的新會話中也可以使用該環(huán)境變量,可以把以下命令語句復(fù)制并添加到~/.bashrc文件中:

# 用您的 API-KEY 代替 YOUR_DASHSCOPE_API_KEY
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

或直接運(yùn)行以下命令將上述命令語句添加到~/.bashrc中:

# 用您的 API-KEY 代替 YOUR_DASHSCOPE_API_KEY
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bashrc

添加完成后,您可以運(yùn)行以下命令使環(huán)境變量生效:

source ~/.bashrc

您可以新建一個會話,運(yùn)行以下命令檢查環(huán)境變量是否生效:

echo $DASHSCOPE_API_KEY
方式二:在代碼中顯式配置API-KEY

我們不建議您將API-KEY直接寫在代碼中,可能存在泄露風(fēng)險。如果您沒有配置環(huán)境變量,可以參考以下示例代碼,在代碼中配置API-KEY。

import dashscope
dashscope.api_key="YOUR_DASHSCOPE_API_KEY"

5. 請求示例

提交接口調(diào)用
curl --location 'https://dashscope.aliyuncs.com/api/v1/uploads?action=getPolicy&model=qwen-vl-plus' \
--header 'Authorization: Bearer your-dashscope-api-key' \
--header 'Content-Type: application/json'
入?yún)⒚枋?/h5>
傳參方式字段類型必選描述示例值
HeaderContent-Typestring請求類型:application/json 。application/json
AuthorizationstringAPI-Key,例如:Bearer d1**2a。Bearer d1**2a
Queryactionstring操作類型,當(dāng)前場景為getPolicy。getPolicy
modelstring指明數(shù)據(jù)準(zhǔn)備完成后最終需要調(diào)用的模型名稱。qwen-vl-plus
出參描述
字段類型描述示例值
request_idstring本次請求的系統(tǒng)唯一碼。7574ee8f-38a3-4b1e-9280-11c33ab46e51
dataobject
data.policystring上傳憑證。eyJleHBpcmF0aW9 … … … dHJ1ZSJ9XX0=
data.signaturestring上傳憑證的簽名。Sm/tv7DcZuTZftFVvt5yOoSETsc=
data.upload_dirstring上傳文件的目錄。dashscope-instant/088726756f74fece22e2a645e2600c01/20xx-xx-xx/c0087628-5c77-90de-bf38-61ecc3a032bc
data.upload_hoststring上傳的host地址。https://dashscope.oss-cn-beijing.aliyuncs.com
data.expire_in_secondsstring上傳憑證過期時間(單位秒)。300
data.max_file_size_mbstring本次最大允許的上傳文件的大?。▎挝籑B),和用戶需要訪問的模型相關(guān)。100
data.capacity_limit_mbstring同一個用戶每天的上傳容量限制(單位MB)。999999999
data.oss_access_key_idstring用于上傳的access key。LTAm5tHvsJAXf7ndvSyY****
data.x_oss_object_aclstring上傳的文件訪問權(quán)限,private意味著私有。private
data.x_oss_forbid_overwritestring文件同名時是否可以覆蓋,true意味著不可覆蓋。true
響應(yīng)示例
{
"request_id": "xxx",
"data": {
"policy": "eyJl...1ZSJ9XX0=",
"signature": "g5K...d40=",
"upload_dir": "dashscope-instant/xxx/2024-07-18/xxxx",
"upload_host": "https://dashscope-file-xxx.oss-cn-beijing.aliyuncs.com",
"expire_in_seconds": 300,
"max_file_size_mb": 100,
"capacity_limit_mb": 999999999,
"oss_access_key_id": "LTAxxx",
"x_oss_object_acl": "private",
"x_oss_forbid_overwrite": "true"
}
}

6. 常見問題

Q:如何找到通義千問API

A:冪簡集成是國內(nèi)領(lǐng)先的API集成管理平臺,專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API:通過關(guān)鍵詞搜索API(例如,輸入’通義千問API‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁進(jìn)入尋找。

Q:語音模型計價?
A:

文字轉(zhuǎn)語音(Text-to-Speech)

下表以 1K 字符 為計價單位,列出 通義千問 中調(diào)用 TTS 模型對應(yīng)的計算積分。

模型:OpenAI TTS 輸入1k 字符:15,000計算積分

模型:OpenAI TTS HD 輸入1k 字符:30,000計算積分

語音轉(zhuǎn)文字(Speech-to-Text)

下表以 每分鐘 為計價單位,列出 通義千問 中調(diào)用 STT 模型對應(yīng)的計算積分。

模型:OpenAI Whisper

輸入每分鐘:6,000計算積分

Q:什么是API-KEY?
A:DashScope通過API-KEY進(jìn)行調(diào)用鑒權(quán)和計量計費(fèi),目前支持主賬號進(jìn)行API-KEY的管理。

Q:API-KEY的上限個數(shù)是多少?
A:當(dāng)前每個主賬號可以同時有3個生效的API-KEY。

Q:API-KEY被刪除會有什么影響?
A:目前支持主賬號對API-KEY的刪除,子賬號無法進(jìn)行操作。刪除的API-KEY無法找回也無法使用,但您在調(diào)用統(tǒng)計頁面仍能查詢被刪除的API-KEY以往的調(diào)用統(tǒng)計結(jié)果。

Q:新上架的模型是否需要重新開通?

A:當(dāng)您已完成服務(wù)開通后,DashScope提供的模型有新增或迭代時,您無需重新開通即可直接按照流程進(jìn)行調(diào)用。

Q:通義千問API的替代品有哪些?

提供AI大模型API的服務(wù)商除了通義千問API,還有其他替代服務(wù)商也提供類似api服務(wù),例如:

360多模態(tài)大語言模型、語音大模型服務(wù)MiniMax-稀宇科技通用大模型開放平臺-華藏、訊飛星火認(rèn)知大模型

更多競品可以在冪簡集成開放平臺中找到。

Q:通義千問API這個密鑰還適用于哪些api?

錄音文件識別阿里云百煉、文字識別

7.  總結(jié)

本文旨在為開發(fā)者提供一個詳盡而實用的指南,幫助他們順利獲取Serper API密鑰,并將其有效集成到應(yīng)用中。通過一系列清晰明確的步驟,從注冊Serper API賬號、完成開發(fā)者認(rèn)證,到最終獲取API服務(wù)密鑰,我們詳細(xì)闡述了整個獲取過程。此外,本文還強(qiáng)調(diào)了獲取密鑰后進(jìn)行可用性測試的重要性,以確保開發(fā)者能夠充分利用Serper API的功能,并避免在集成過程中出現(xiàn)不必要的錯誤。這一環(huán)節(jié)對于提升應(yīng)用的交互性和功能性至關(guān)重要。本文為開發(fā)者提供了一個全面、系統(tǒng)的指南,旨在幫助他們輕松獲取Serper API密鑰,并將其轉(zhuǎn)化為推動應(yīng)用發(fā)展的強(qiáng)大動力。通過遵循本文提供的步驟和建議,開發(fā)者將能夠更高效地利用Serper API,為他們的應(yīng)用注入更多創(chuàng)新和活力。

上一篇:

將醫(yī)學(xué)影像 Healthcare API 集成到您的醫(yī)療保健系統(tǒng)中...

下一篇:

如何獲取 Seeed 開放平臺 API Key 密鑰(分步指南)
#你可能也喜歡這些API文章!

我們有何不同?

API服務(wù)商零注冊

多API并行試用

數(shù)據(jù)驅(qū)動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

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

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

#AI深度推理大模型API

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

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