更新时间：2025-09-15 GMT+08:00
调用说明
只有当预置服务-商用服务的付费状态为“已开通”、或者自定义接入点的状态为“使用中”时，预置服务才可被成功调用。
服务调用产生的内容由AI生成，不代表ModelArts Studio观点，平台不保证其合法性、真实性、准确性，不承担相关法律责任。
步骤一：获取API Key
在调用MaaS的模型服务时，需要填写API Key用于接口的鉴权认证。请创建新的API Key或使用已有API Key。关于如何创建API Key，请参见在ModelArts Studio（MaaS）管理API Key。
步骤二：调用重排序模型
复制以下调用示例并替换接口信息、API Key。
|
名称 |
说明 |
取值 |
|---|---|---|
|
API地址 |
调用重排序模型的API地址。 |
https://api.modelarts-maas.com/v1/rerank |
|
model参数 |
model参数调用名称。 |
|
Rest API的示例代码如下。
- 使用Python调用示例。
import requests import json if __name__ == '__main__': url = "https://api.modelarts-maas.com/v1/rerank" # API地址 api_key = "MAAS_API_KEY" # 把MAAS_API_KEY替换成已获取的API Key # Send request. headers = { 'Content-Type': 'application/json', 'Authorization': f'Bearer {api_key}' } data = { "model": "bge-reranker-v2-m3", "query": "如何冲泡一杯好喝的咖啡？", # input类型可为string或string[]。 "documents": [ "咖啡豆的产地主要分布在赤道附近，被称为‘咖啡带’。", "法压壶的步骤：1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。", "意式浓缩咖啡需要一台高压机器，在9个大气压下快速萃取。", "挑选咖啡豆时，要注意其烘焙日期，新鲜的豆子风味更佳。", "手冲咖啡的技巧：控制水流速度、均匀注水和合适的水温（90-96°C）是关键。" ] } response = requests.post(url, headers=headers, data=json.dumps(data), verify=False) # Print result. print(response.status_code) print(response.text) - 使用cURL调用示例。
curl -X POST "https://api.modelarts-maas.com/v1/rerank" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $MAAS_API_KEY" \ -d '{ "model": "bge-reranker-v2-m3", "input": "如何冲泡一杯好喝的咖啡？", "documents": [ "咖啡豆的产地主要分布在赤道附近，被称为‘咖啡带’。", "法压壶的步骤：1. 研磨咖啡豆。2. 加入热水。3. 压下压杆。4. 倒入杯中。", "意式浓缩咖啡需要一台高压机器，在9个大气压下快速萃取。", "挑选咖啡豆时，要注意其烘焙日期，新鲜的豆子风味更佳。" "手冲咖啡的技巧：控制水流速度、均匀注水和合适的水温（90-96°C）是关键。" ] }'
