使用這些基本 REST API 最佳實踐構建出色的 API
2.創建賬戶以后到郵箱中需要驗證。
3.登錄成功以后就會進入到控制臺頁面。
4.點擊左側導航欄中的 API訪問 ，在當前頁面就可以看到密鑰相關信息。
在獲取API密鑰后，進行可用性測試是確保其正常工作的重要步驟。以下是使用curl進行測試的一個案例
以下接口為SupaRes 開放平臺接口中面部增強接口
輸入：
curl https://api.supares.com/1.0/fetch
--user your-api-key: \
--header "Content-Type: application/json" \
--data '{
"url": "https://www.website.com/image.jpg",
"face": {
"enhance": true
}
}'對于圖像處理端點/1.0/upload和/1.0/fetch的每個請求，API 將立即返回一個唯一的請求id ，狀態代碼為202 Accepted 。
輸出：
{
"success": true,
"code": 202,
"id": "051d58e6-2ef8-4dcc-bc9b-bd76bd8b124f"
}訪問增強以后的圖片
SupaRes API 公開/1.0/results/{id}端點，您可以使用該端點通過簡單的輪詢機制獲取請求的結果。例如：
輸入
curl -u your-api-key: https://api.supares.com/1.0/results/051d58e6-2ef8-4dcc-bc9b-bd76bd8b124f輸出結果
包含了圖像的相關信息，例如url地址圖像的大小等信息。
{
"success": true,
"code": 200,
"id": "051d58e6-2ef8-4dcc-bc9b-bd76bd8b124f",
"status": "ready",
"url": "https://s3.supares.com/temp-supares/JMxbLxAomXi55re4D5zV/051d58e6-2ef8-4dcc-bc9b-bd76bd8b124f/1-input.webp",
"metadata": {
"format": "webp",
"width": 500,
"height": 200,
"bytes": 23718,
"space": "srgb",
"channels": 3
}
}在使用SupaRes 開放平臺 API搭建應用時，除了獲取和測試API密鑰外，還需考慮以下因素：
對 API 的所有請求都必須使用HTTP Basic Auth或Bearer Auth通過您唯一的 API 密鑰進行身份驗證。使用 HTTP 基本身份驗證時，您必須提供 API 密鑰作為用戶名值。您不需要提供密碼。如果您需要使用 Authorization 標頭通過 Bearer Auth 進行身份驗證，則必須將 API 密鑰設置為憑據。
所有 API 請求都必須使用 HTTPS 協議發出，以便對流量進行加密。通過純 HTTP 進行的調用以及未經身份驗證的請求都會失敗。
為了保護 SupaRes 平臺并確保系統資源的公平分配，所有請求，無論使用哪種 HTTP 方法和端點，都按每個密鑰進行速率限制。速率限制分為 15 分鐘間隔，您每 15 分鐘最多可以發出100,000 （十萬）個請求，這對于合理使用來說綽綽有余（大約每秒 110 個請求）。您將在每個響應中找到標準X-RateLimit-*標頭，以幫助您跟蹤使用情況。
X-RateLimit-Limit: 100000 | 當期允許的請求數 |
|---|---|
X-RateLimit-Remaining: 2120 | 本期剩余請求數 |
X-RateLimit-Reset: 778 | 當前時間段剩余秒數 |
SupaRes API 返回傳統的 HTTP 響應代碼以指示 API 請求的成功或失敗。成功的請求將始終產生2xx代碼范圍。 4xx范圍內的狀態代碼通常表示發送的請求存在問題（例如省略了必需的參數）。如果您收到5xx范圍內的狀態，這通常表明存在服務器端問題，并且意味著我們這邊遇到問題，當前無法滿足您的請求。
在申請和使用 SupaRes 開放平臺 API密鑰過程中，你可能會遇到以下常見問題：
提供免費計劃嗎？
我們提供免費計劃，并且注冊不需要信用卡。每次注冊一開始都是免費計劃，一次性配額為 10 個積分。
我可以稍后更改計劃嗎？
您可以在付費計劃之間切換，或者隨時完全取消您的帳戶。我們將相應地調整任何付款。
積分如何運作？
1 個積分等于處理 1 張圖像。我們不會對每次操作收取任何額外費用。這意味著您可以在一張圖像上應用我們提供的每一種人工智能圖像增強功能，我們將從您的帳戶中扣除一筆積分。
需要信用卡才能注冊嗎？ 如果您選擇購買按月訂閱，則只會要求您提供信用卡或借記卡。您無需輸入任何付款信息即可開始免費計劃。
在獲得SupaRes 開放平臺 API密鑰之后，即可開啟API接口對接，本文整理了多篇使用SupaRes 開放平臺 API的案例，幫助讀者更有效地使用SupaRes 開放平臺 API：
音調調整、 噪音消除、 減少偽影、 圖像優化、 圖片上傳、 圖像獲取
問題1： 什么是冪簡集成平臺？
冪簡集成是蜜堂有信在2023年打造的一款SAAS產品，建設著國內最全的API平臺，為開發者提供全面、高效、易用的API集成管理方案，一站搜索、試用、集成國內和國外API。讓用戶在AI時代全方位接入互聯網，用API連接一切服務和算力，實現價值倍增。
問題2：如何找到SupaRes 開放平臺 API
冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’SupaRes 開放平臺 API‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。
問題3：SupaRes 開放平臺 API的替代品有哪些？
市場上存在免費、付費兩種替代者
例如
更多競品可以在SupaRes 開放平臺找到。
本文詳細介紹了如何獲取和測試SupaRes開放平臺API密鑰，并提供了使用curl進行可用性測試的具體示例。通過測試，開發者能夠確認API的正常工作，并了解如何通過輪詢機制獲取處理后的圖像。文章還探討了在使用SupaRes API時需要注意的關鍵因素，如身份驗證、速率限制和錯誤處理等，幫助開發者更好地集成該平臺的圖像處理功能。