Model API 提供大語言模型的調用能力。本文介紹如何將 Model API 封裝為 API 產品,發布到開發人員門戶,供開發人員瀏覽和訂閱。
前提條件
已建立 Model API,詳見管理Model API
已建立開發人員門戶。詳見建立門戶。
建立 API 產品
登入開放平台控制台。
在左側導覽列,選擇 API 產品。
單擊 建立 API 產品。
在建立面板,填寫產品基本資料。
欄位
說明
產品名稱
產品的唯一標識,例如
model-api-product。必填。產品描述
簡要描述產品的功能和用途。必填。
產品類型
選擇 Model API。必填。
產品類別
選擇產品類別,支援自訂。選填。
自動訂閱審批
開啟後,開發人員的訂閱申請將自動通過。門戶和 API 產品均可配置此選項,API 產品的配置優先順序更高。
產品表徵圖
可使用 URL 連結或上傳本地檔案。選填。
配置模型參數。
參數
說明
Model
模型名稱,例如
qwen-turbo。Max Tokens
最大產生令牌數,控制返回內容的長度。
Temperature
採樣溫度,控制產生內容的隨機性,取值範圍 0~2。
支援連網搜尋
是否啟用 Web Search 能力。
說明模型參數用於 HiMarket 前台調試模型時使用,參數缺失可能導致模型調用失敗,請確保配置完整。
單擊 確定,完成建立。
關聯 API
API 產品必須關聯具體的 AI API 後才能發布到門戶。
在 API 產品詳情頁,單擊 關聯 API。
選擇網關執行個體和 Model API。
單擊 關聯。
關聯成功後,產品狀態變為 待發布,頁面會顯示 Model API 的路由資訊。
編寫使用指南
使用指南協助開發人員快速瞭解和使用 API 產品。一份完善的指南應包含產品介紹、介面說明、調用樣本等內容,能有效降低開發人員的上手成本。
在 API 產品詳情頁,單擊 使用指南 頁簽。
使用 Markdown 編輯器編寫文檔,或上傳已有的 Markdown 檔案。
單擊 儲存。
發布到門戶
確認產品狀態為 待發布。
單擊 發布到門戶。
選擇目標門戶。
單擊 發布。
發布後,開發人員即可在門戶中瀏覽和訂閱該產品。