2. 開通DashScope

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

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

3. 獲取API-KEY

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

  1. 訪問DashScope管理控制臺API-KEY管理頁面:前往API-KEY管理,單擊創建新的API-KEYAPI-KEY.jpg
  2. 系統創建生成API-KEY,并在彈出的對話框中展示,您可以單擊復制按鈕將API-KEY的內容復制保存。查看API-KEY00.jpg
  3. 復制并在安全的地方保存API-KEY后,單擊我已保存,關閉。此次創建的API-KEY可立即用于調用DashScopeAPI,對API-KEY的后續操作均可在當前的API-KEY管理頁面進行。API-KEY.jpg

4. 配置API

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

方式一:通過環境變量設置API-KEY(推薦)

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

方式一:添加臨時性環境變量

如果您僅需要在當前會話中添加并使用臨時性環境變量,可以運行以下命令:

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

您可以在當前會話運行以下命令檢查環境變量是否生效:

echo $DASHSCOPE_API_KEY
方式二:對當前用戶添加永久性環境變量

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

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

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

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

添加完成后,您可以運行以下命令使環境變量生效:

source ~/.bashrc

您可以新建一個會話,運行以下命令檢查環境變量是否生效:

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

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

import dashscope
dashscope.api_key="YOUR_DASHSCOPE_API_KEY"

5. 請求示例

提交接口調用
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'
入參描述
傳參方式字段類型必選描述示例值
HeaderContent-Typestring請求類型:application/json 。application/json
AuthorizationstringAPI-Key,例如:Bearer d1**2a。Bearer d1**2a
Queryactionstring操作類型,當前場景為getPolicy。getPolicy
modelstring指明數據準備完成后最終需要調用的模型名稱。qwen-vl-plus
出參描述
字段類型描述示例值
request_idstring本次請求的系統唯一碼。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本次最大允許的上傳文件的大小(單位MB),和用戶需要訪問的模型相關。100
data.capacity_limit_mbstring同一個用戶每天的上傳容量限制(單位MB)。999999999
data.oss_access_key_idstring用于上傳的access key。LTAm5tHvsJAXf7ndvSyY****
data.x_oss_object_aclstring上傳的文件訪問權限,private意味著私有。private
data.x_oss_forbid_overwritestring文件同名時是否可以覆蓋,true意味著不可覆蓋。true
響應示例
{
"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:冪簡集成是國內領先的API集成管理平臺,專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API:通過關鍵詞搜索API(例如,輸入’通義千問API‘這類品類詞,更容易找到結果)、或者從API hub分類頁進入尋找。

Q:語音模型計價?
A:

文字轉語音(Text-to-Speech)

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

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

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

語音轉文字(Speech-to-Text)

下表以 每分鐘 為計價單位,列出 通義千問 中調用 STT 模型對應的計算積分。

模型:OpenAI Whisper

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

Q:什么是API-KEY?
A:DashScope通過API-KEY進行調用鑒權和計量計費,目前支持主賬號進行API-KEY的管理。

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

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

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

A:當您已完成服務開通后,DashScope提供的模型有新增或迭代時,您無需重新開通即可直接按照流程進行調用。

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

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

360多模態大語言模型語音大模型服務MiniMax-稀宇科技通用大模型開放平臺-華藏訊飛星火認知大模型

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

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

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

7.  總結

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

上一篇:

使用 Axios 在 React 中創建集中式 API 客戶端文件

下一篇:

如何獲取Microsoft API Key 密鑰實現bing搜索分步指南
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

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

10個渠道
一鍵對比試用API 限時免費