SuperApp：如何調用統一API

第一步：配置 API 金鑰

在調用 API 之前，您需要建立並配置 API 金鑰以完成身分識別驗證。API 金鑰可確保對已部署模型的安全訪問，並用於追蹤計費用量。

進入 Secrets 菜單

如需建立新的 API 金鑰，請導航至平台介面左下角的「Secrets」菜單。

建立新的 API 金鑰

建立新的 API 金鑰以對 API 請求進行身分識別驗證。通過配置密鑰設定，管控對資源的存取權限。

名稱：為 API 金鑰輸入一個描述性名稱。不允許使用特殊字元（空格、#、?）。

存取範圍

配置此 API 金鑰可訪問的資源範圍：

部署：選擇特定的已部署模型，或勾選「所有模型」以授予對所有部署的存取權限。

路由：選擇路由供應商。如需添加更多供應商，請聯絡我們。

BYOK：選擇特定的 BYOK 配置，或勾選「所有 BYOK」以授予對所有配置的存取權限。

用量限制

TPM（每分鐘 Token 數）：每分鐘最大處理 Token 數（例如：60000）。

年度 Token 限額：每年允許使用的最大 Token 總量（例如：10000000）。

安全設定（可選）

IP 白名單：限制特定 IP 位址的存取權限。多個地址請以英文逗號分隔（例如：192.168.1.1, 10.0.0.0/8）。

有效期間：為 API 金鑰設定到期時間。

重要提示：請將您的 API 金鑰妥善儲存。出於安全考慮，切勿在公開環境或共用文檔中暴露密鑰資訊。

第二步：查看程式碼範例

建立 API 金鑰後，您可以訪問現成的程式碼範例，瞭解如何與已部署的模型進行整合。這些樣本包含完整的身分識別驗證方式及 API 呼叫模式。

擷取程式碼範例

程式碼範例可在每個已部署模型的詳情頁中查看。這些樣本將展示如何使用您的 API 金鑰發起請求。

部署詳情中的程式碼範例地區，已整合 API 金鑰

1. 進入部署詳情

前往「部署」頁面，點擊具體的部署專案以查看其詳情。

2. 找到程式碼範例地區

在部署詳情頁中找到「程式碼範例」地區。

3. 複製並自訂

複製提供的程式碼範例，並將佔位符 API 金鑰替換為您的實際密鑰。

範例程式碼結構

程式碼範例通常包含以下組成部分

from openai import OpenAI
client = OpenAI(
    api_key="<API_KEY>",
    base_url="https://rpgateway.console.alibabacloud.com/v1"
)
response = client.chat.completions.create(
    model="@sss/Qwen/Qwen3-0.6B-Base",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "how are you"}
    ],
    temperature=0.7,
    max_tokens=150
)

• API 金鑰：將 <API_KEY> 替換為您在 Secrets 中擷取的實際 API 金鑰

• Base URL：所有 API 呼叫的統一接入端點

• 模型：您的部署所對應的模型標識符

最佳實務

• 妥善保管 API 金鑰，切勿在用戶端代碼中暴露

• 為 API 請求實現完善的錯誤處理機制

• 持續監控 API 用量，最佳化成本與效能

• 合理設定限流策略，避免超出 API 配額