2024年您產品必備的10大AI API推薦
2.進入儀表盤：進入儀表盤頁面，對密鑰進行操作。
3.創建API密鑰：點擊“儀表盤” >在左側導航欄中選擇 “API密鑰”>創建新密鑰
4.查看API密鑰：新建完以后會提示創建成功，在這里會看到新建的密鑰。
在獲取API密鑰后，進行可用性測試是確保其正常工作的重要步驟。以下是使用CURL進行測試的一個案例：
輸入：
curl --location 'https://api.upstage.ai/v1/solar/chat/completions' \
--header 'Authorization: Bearer up_5NbV1mb4JG06PEQPFPHDL47ZOTcaM' \
--header 'Content-Type: application/json' \
--data '{
"model": "solar-pro",
"messages": [
{
"role": "user",
"content": "Hi, how are you?"
}
],
"stream": true
}'輸出：
你將得到一個JSON格式的響應，其中包含了詳細信息，如當前對話的模型輸出內容、模型名稱、用戶輸入的token數量、模型輸出的token數量等。
示例輸出：
{
"id": "e1a90437-df41-45cd-acc6-a7bacbdd2a86",
"object": "chat.completion",
"created": 1707269210,
"model": "solar-pro-preview-240910",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello and welcome! How can I assist you today?"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 23,
"completion_tokens": 12,
"total_tokens": 35
},
"system_fingerprint": null
}在使用Upstage API搭建應用時，除了獲取和測試API密鑰外，還需考慮以下因素：
| 代碼 | 原因 | 可能的解決方法 |
|---|---|---|
| 400 | 請求體格式或數據錯誤 | 對于Solar API： ? 檢查請求體的JSON語法是否正確 ? 檢查請求體中是否存在所有必需鍵 ? 檢查請求體中的所有鍵是否正確 ? 檢查請求體中所有值的類型是否正確 ? 檢查請求體中的所有值是否正確 ? 檢查是否有拼寫錯誤！ 對于Document AI API： ? 檢查請求體中的文檔文件位置是否正確 ? 檢查文檔文件是否為支持的格式 ? 檢查文檔文件大小是否小于50MB ? 檢查是否有拼寫錯誤！ |
| 401 | 提供的API密鑰無效 | ? 檢查是否在請求頭中設置了API密鑰 ? 檢查Authorization頭是否為正確的格式 – “Bearer API_KEY” ? 檢查API密鑰是否未在控制臺中刪除 ? 檢查是否有拼寫錯誤！ |
| 403 | 信用額度不足 | 您的信用額度不足。請注冊付款方式。 |
| 404 | URL路徑錯誤 | ? 檢查請求路徑是否正確 |
| 405 | 使用http://的URL路徑錯誤 | ? 使用https://代替http:// |
| 429 | 在特定時間段內請求過多 | ? 檢查是否發送了超出限制的請求 ? 如果需要增加請求頻率限制，請聯系支持人員 |
| 500 / 502 / 503 / 504 | 處理請求時出現錯誤 | ? 稍后重試請求 ? 如果仍然收到錯誤，請聯系支持人員 |
為了維護系統穩定性并確保公平的資源分配，我們的服務對 API 請求實施速率限制。
| 模型 | 每分鐘請求限制 (RPM) | 每月請求限制 (TPM) |
|---|---|---|
| solar-pro | 100 | 100,000 |
| solar-docvision | 50 | 100,000 |
| solar-mini | 100 | 100,000 |
| translation-koen | 100 | 100,000 |
| translation-enko | 100 | 100,000 |
| groundedness-check | 100 | 100,000 |
| 模型 | 每分鐘請求限制 (RPM) | 每月請求限制 (TPM) |
|---|---|---|
| embedding-passage | 300 | 300,000 |
| embedding-query | 300 | 300,000 |
| 模型 | 每秒請求限制 (RPS) |
|---|---|
| document-parse | 10 |
| document-parse (異步) | 30 |
| 模型 | 每秒請求限制 (RPS) |
|---|---|
| ocr-2.2.1 | 1 |
| 模型 | 每秒請求限制 (RPS) |
|---|---|
| air-waybill-extraction-4.1.6 | 1 |
| bill-of-lading-and-shipping-request-extraction-4.1.6 | 1 |
| commercial-invoice-and-packing-list-extraction-4.1.6 | 1 |
| kr-export-declaration-certificate-extraction-4.1.6 | 1 |
| receipt-extraction-3.2.0 | 1 |
在申請和使用 Upstage API密鑰過程中，你可能會遇到以下常見問題：
1. 我在登錄或注冊時遇到問題？
2. 為什么我在 API 請求期間收到“401 未經授權”錯誤？
當無法使用 api 密鑰執行身份驗證時，會出現此問題。請檢查您是否在請求標頭中正確寫入了Authorization值。
3. 為什么我在 API 請求期間收到“415 不支持的媒體類型”錯誤？
當文檔格式不受支持時會出現此問題。檢查正在使用的 API 支持的文件格式。
4. 我可以一次請求多份文件嗎？
我們目前不提供一次請求多個文檔的接口。我們建議一次連續發送一張圖像，而不是同時發送多個請求。一次發送多個請求可能會導致“429 Too Many Requests”錯誤。
5. 為什么我會收到 429 錯誤（速率限制）？
速率限制是我們的 API 對用戶在給定時間范圍內發出請求的頻率設置的限制。詳細信息請參閱速率限制頁面。如果遇到 429 錯誤，請降低請求頻率，并在幾秒或一分鐘后重試。要請求更高的速率限制，請訪問我們的支持頁面并提交限制增加請求。
在獲得Upstage API密鑰之后，即可開啟API接口對接，本文整理了多篇使用Upstage API的案例，幫助讀者更有效地使用Upstage API：
問題1： 什么是冪簡集成平臺？
冪簡集成是蜜堂有信在2023年打造的一款SAAS產品，建設著國內最全的API平臺，為開發者提供全面、高效、易用的API集成管理方案，一站搜索、試用、集成國內和國外API。讓用戶在AI時代全方位接入互聯網，用API連接一切服務和算力，實現價值倍增。
問題2：如何找到Upstage API
冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’Upstage API‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。
問題3：Upstage API的替代品有哪些？
市場上存在免費、付費兩種替代者
例如
更多競品可以在Upstage開放平臺找到。
本文詳細介紹了如何申請、測試和使用Upstage API密鑰，并為開發者提供了實際的API使用示例和常見問題解答。通過API密鑰的獲取與測試，開發者可以確保API正常工作并進行應用開發。在搭建應用時，除了密鑰的管理，還需注意錯誤處理、速率限制和不同服務的請求限制，以優化使用體驗。此外，我們還提供了常見問題的解答，幫助開發者在使用過程中解決常見問題。最后，我們介紹了Upstage的進階使用指引和其他相關API服務，幫助開發者更好地集成并利用Upstage平臺的功能。
