
2025 Prometheus API 完整指南:基礎查詢、PromQL 高級用法與自定義監控實踐
點擊右側訪問官網,點擊官網右上角注冊或登錄。
2.登錄以后點擊右上角立即開通按鈕。(新用戶注冊送100萬免費Token)
3.這里可以看到相關模型的詳細信息。點擊確認開通。
4.開通以后點擊右上角這個 設置 圖標。
5.點擊左側導航欄中的 API Key,然后創建。
6.創建成功以后就可以看到自己的密鑰了。
在獲取API密鑰后,進行可用性測試是確保其正常工作的重要步驟。以下是使用curl進行測試的一個案例
以下接口為阿里云百煉 開放平臺接口中 通義千問 接口。
輸入:
curl --location --request POST 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 你的密鑰' \
--header 'Accept: */*' \
--header 'Host: dashscope.aliyuncs.com' \
--header 'Connection: keep-alive' \
--data-raw '{
? "model": "qwen-plus",
? "messages": [
? ? ? {
? ? ? ? ? "role": "system",
? ? ? ? ? "content": "你是一個編程專家"
? ? ? },
? ? ? {
? ? ? ? ? "role": "user",
? ? ? ? ? "content": "用js寫一個1-100的隨機函數"
? ? ? }
? ]
}'
輸出:
結果以 JSON 格式返回,內容包含一次對話補全的完整信息,其中包括模型生成的回答內容、角色標識、結束原因及索引位置等;同時還記錄了調用模型的對象類型、使用的 token 數量明細(提示詞、補全、總數)、創建時間戳、模型 ID 以及會話唯一標識符等關鍵信息,全面展示了本次請求的輸入輸出過程和資源消耗情況。
{
? "choices": [
? ? ? {
? ? ? ? ? "message": {
? ? ? ? ? ? ? "role": "assistant",
? ? ? ? ? ? ? "content": "你可以使用 JavaScript 的 Math.random()
和 Math.floor()
方法來創建一個生成 1 到 100 之間(包括 1 和 100)的隨機整數的函數。以下是實現代碼:\n\n``javascript\nfunction getRandomNumber() {\n return Math.floor(Math.random() * 100) + 1;\n}\n
`\n\n### 解釋:\n-
Math.random():生成一個 0(包含)到 1(不包含)之間的隨機小數,例如
0.34234。\n-
Math.random() * 100:將這個范圍擴展到 0(包含)到 100(不包含),例如
99.23。\n-
Math.floor(...):向下取整,得到 0 到 99 的整數。\n-
+ 1:將范圍從 0-99 變為 1-100。\n\n### 使用示例:\n
`javascript\nconsole.log(getRandomNumber()); // 輸出一個 1 到 100 之間的隨機整數\n
`\n\n每次調用
getRandomNumber()` 都會返回一個不同的數字(每次都是 1 到 100 之間)。"
? ? ? ? ? },
? ? ? ? ? "finish_reason": "stop",
? ? ? ? ? "index": 0,
? ? ? ? ? "logprobs": null
? ? ? }
? ],
? "object": "chat.completion",
? "usage": {
? ? ? "prompt_tokens": 33,
? ? ? "completion_tokens": 267,
? ? ? "total_tokens": 300,
? ? ? "prompt_tokens_details": {
? ? ? ? ? "cached_tokens": 0
? ? ? }
? },
? "created": 1756182993,
? "system_fingerprint": null,
? "model": "qwen-plus",
? "id": "chatcmpl-47a981a6-8a66-9b89-ae79-f09135f7a90e"
}
在使用阿里云百煉 開放平臺API搭建應用時,除了獲取和測試API密鑰外,還需考慮以下因素:
開通阿里云百煉后,您需要手動創建API Key,系統不會自動生成。
https://dashscope.aliyuncs.com/compatible-mode/v1
請勿以任何方式公開API Key,避免因未經授權的使用導致安全風險或資金損失。
通過API-Key頁面創建的API Key永久有效,手動刪除后即失效。
若需為第三方應用或用戶提供臨時訪問權限,或需嚴格控制敏感數據訪問、刪除等高風險操作,可獲取臨時鑒權Token(有效期60秒),避免暴露長期有效的API Key,降低泄露風險。
官方文檔中錯誤碼比較多,以下為我本人總結出的經常可能會遇到情況。
HTTP 狀態碼 | 錯誤類型 | 典型錯誤信息 | 主要原因 | 解決方案 |
---|---|---|---|---|
200 | ? 成功 | — | 請求正常處理 | — |
400 | 參數錯誤(Bad Request) | Required body invalid you must provide a model parameter temperature must be Float | 請求體錯誤 / 參數缺失 / 參數類型不符 | 檢查 model 、messages 、參數類型是否正確 |
401 | 認證錯誤(Unauthorized) | No api key provided The api_key client option must be set... | API Key 缺失或無效 | 配置 api_key 或環境變量 |
403 | 權限錯誤(Forbidden) | You do not have access to this model | API Key 權限不足 / 模型未開通 | 檢查是否開通相應模型或權限 |
404 | 資源錯誤(Not Found) | The model is not available | 模型或接口不存在 | 確認模型名稱 / API 路徑 |
409 | 沖突錯誤(Conflict) | Request already processed | 重復請求 / 并發沖突 | 避免重復提交,處理冪等邏輯 |
413 | 請求體過大(Payload Too Large) | File is too large | 上傳文件超限 | 壓縮或分割文件 |
415 | 不支持的格式(Unsupported Media Type) | Invalid file format | 文件格式不支持 | 轉換成支持的格式(txt、json、csv 等) |
429 | 速率限制(Rate Limit) | Too Many Requests | 請求頻率超限 | 增加重試(指數退避),或升級額度 |
500 | 服務器錯誤(Internal Server Error) | An internal error occurred | 服務端異常 | 稍后重試,若持續出現聯系支持 |
502 / 503 / 504 | 網關/服務不可用 | Bad Gateway / Service Unavailable / Gateway Timeout | 服務不可用或超時 | 重試,請求增加容錯機制 |
在申請和使用 阿里云百煉 開放平臺 API密鑰過程中,你可能會遇到以下常見問題:
1.如何配置域名白名單以訪問圖片OSS鏈接?
圖像模型生成的圖像存儲于阿里云OSS,每張圖像會被分配一個OSS鏈接,如https://dashscope-result-xx.oss-cn-xxxx.aliyuncs.com/xxx.png
。圖片OSS鏈接允許公開訪問,您可以使用此鏈接查看或者下載圖片。
2.海外調用API接口顯示資源下載超時?
報錯場景:您在海外調用接口,且圖片資源存儲于非中國內地地域,較大概率出現資源下載超時報錯,報錯信息如下所示。
Download the media resource timed out during the data inspection process
主要原因:非中國內地地區存在不穩定因素,因此在下載圖片時會導致超時情況。
解決方案:請將圖片資源存儲在中國內地的地域,并配置加速。注意,當前不支持配置主賬號的圖片下載超時時間。
3.圖像無法下載或下載失敗?
報錯場景:當使用您自己的圖片鏈接(非文檔示例圖片鏈接)請求接口時,報錯提示“下載圖片失敗,請檢查圖片url”。
{
? ?"request_id": "657f0d1b-76d0-9e3e-b6d6-xxxxxx",
? ?"output": {
? ? ? ?"task_id": "5e6fa974-9a25-4271-8659-xxxxxx",
? ? ? ?"task_status": "FAILED",
? ? ? ?"code": "BadRequest.InputDownloadFailed",
? ? ? ?"message": "Reference image download failed, please check image url."
? }
}
可能原因:輸入的圖片URL鏈接存在錯誤、無法訪問或下載權限受限等問題,導致模型服務無法成功下載圖片。
解決方案:請確保圖片URL鏈接完整,并能夠支持公網訪問。您可以將圖片上傳至可供公網訪問的自建存儲服務,或選擇上傳至OSS等云存儲服務。請務必確保圖片URL能夠支持公網訪問。
在獲得阿里云百煉 開放平臺 API密鑰之后,即可開啟API接口對接,本文整理了多篇使用阿里云百煉 開放平臺 API的案例,幫助讀者更有效地使用阿里云百煉 開放平臺 API:
通義千問-文生圖、GLM-4.5、通義萬相-圖生視頻-基于首幀、DeepSeek、Kimi
問題1: 什么是冪簡集成平臺?
冪簡集成是蜜堂有信在2023年打造的一款SAAS產品,建設著國內最全的API平臺,為開發者提供全面、高效、易用的API集成管理方案,一站搜索、試用、集成國內和國外API。讓用戶在AI時代全方位接入互聯網,用API連接一切服務和算力,實現價值倍增。
問題2:如何找到阿里云百煉 開放平臺 API
冪簡API平臺可以通過以下兩種方式找到所需API:通過關鍵詞搜索API(例如,輸入’阿里云百煉 開放平臺 API‘這類品類詞,更容易找到結果)、或者從API hub分類頁進入尋找。
問題3:阿里云百煉 開放平臺 API的替代品有哪些?
市場上存在免費、付費兩種替代者
例如
更多競品可以在阿里云百煉 開放平臺找到。
本文總結了阿里云百煉開放平臺API密鑰的申請、測試與使用方法,從curl調用示例到返回結果解析,再到API調用中的關鍵注意事項與常見錯誤碼,提供了完整的實操參考。文章還梳理了API密鑰的管理方式、時效性說明以及在海外調用、圖片下載等場景中可能遇到的問題和解決方案,并補充了進階指引與常見問題,幫助開發者更高效、安全地將阿里云百煉開放平臺API集成到實際應用中。