文档首页/ 大模型即服务平台 MaaS/ 快速入门/ 首次调用大模型API
更新时间：2026-02-14 GMT+08:00
查看PDF
分享

首次调用大模型API

大模型即服务平台MaaS支持通过API调用大模型。

本文以文本对话预置模型DeepSeek-V3.2为例，快速指导您完成大模型API调用。

准备账号和权限

  1. 已注册华为账号并开通华为云，进行了实名认证，且在使用ModelArts前检查账号状态，账号不能处于欠费或冻结状态。具体操作请参见注册华为账号并开通华为云和实名认证。
  2. 对于所有用户（包括个人用户），需要完成ModelArts委托授权才能使用MaaS服务，否则会造成您的操作出现不可预期的错误。具体操作请参见配置委托授权使用MaaS。

获取API Key

在调用MaaS的模型服务时，需要填写API Key用于接口的鉴权认证。请创建新的API Key或使用已有API Key。

创建API Key：访问API Key管理页面，单击“创建API Key”，创建你的API Key。

开通预置模型服务

该功能仅支持“西南-贵阳一”区域。

  1. 在MaaS控制台左侧导航栏，选择“模型推理 > 在线推理”。
  2. 在“预置服务”页签，选择DeepSeek-V3.2模型服务单击操作列的“开通服务”。
  3. 在开通预置模型服务弹框，默认已勾选待开通的模型服务，确认并勾选“我已阅读并同意上述说明，及《MaaS 服务声明》”，单击“一键开通”。

    当模型服务的状态为开通，表示模型服务已开通。开通后调用以实际用量进行扣费，详情请见模型服务计费项，未使用时不会产生费用。

    图1 开通模型服务

选择开发语言调用大模型API

支持以下语言调用大模型API。

  1. 检查Python版本：

    在终端输入如下命令查看当前计算机环境是否安装了Python和pip。

    python -V
pip --version

    以Windows的CMD为例：

    图2 Windows查看Python版本

    如果未安装Python，请前往Python官网下载Python包并安装，Python版本需要在3.8或以上版本。

  2. 安装requests库。 
    pip3 install requests
  3. 以DeepSeek-V3.2模型为例，运行如下命令发起API请求。可通过model参数替换模型，model参数详情请前往控制台查看预置模型操作列的“调用说明”。 
    import requests
import json

if __name__ == '__main__':
    url = "https://api.modelarts-maas.com/v2/chat/completions"  # 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": "deepseek-v3.2",  # model参数，您可按需更换模型参数
        "messages": [
            {"role": "system", "content": "You are a helpful assistant."},
            {"role": "user", "content": "介绍下你自己"}
        ]
    }
    response = requests.post(url, headers=headers, data=json.dumps(data), verify=False)

    # Print result.
    print(response.status_code)
    print(response.text)

以DeepSeek-V3.2模型为例，运行如下命令发起API请求。可通过model参数替换模型，model参数详情请前往控制台查看预置模型操作列的“调用说明”。

  • Windows

    在CMD（命令提示符）中执行如下命令：

    curl -X POST "https://api.modelarts-maas.com/v2/chat/completions" ^
  -H "Content-Type: application/json" ^
  -H "Authorization: Bearer $MAAS_API_KEY" ^
  -d '{
    "model": "deepseek-v3.2",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "介绍下你自己"}
    ]
  }'
  • Linux/macOS
    在Terminal（终端）中执行如下命令： 
    curl -X POST "https://api.modelarts-maas.com/v2/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MAAS_API_KEY" \
  -d '{
    "model": "deepseek-v3.2",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "介绍下你自己"}
    ],
     "thinking": {
       "type": "enabled"
     }
  }'
  1. 检查Python版本：

    在终端输入如下命令查看当前计算机环境是否安装了Python和pip。

    python -V
pip --version

    以Windows的CMD为例：

    图3 Windows查看Python版本

    如果未安装Python，请前往Python官网下载Python包并安装，Python版本需要在3.8或以上版本。

  2. 安装OpenAI Python SDK。 
    pip install --upgrade "openai>=1.0"
  3. 以DeepSeek-V3.2模型为例，运行如下命令发起API请求。可通过model参数替换模型，model参数详情请前往控制台查看预置模型操作列的“调用说明”。 
    from openai import OpenAI
import httpx

base_url = "https://api.modelarts-maas.com/openai/v1"  # API地址
api_key = "MAAS_API_KEY"  # 把MAAS_API_KEY替换成已获取的API Key


client = OpenAI(api_key=api_key, base_url=base_url, http_client=httpx.Client(verify=False))

response = client.chat.completions.create(
    model="deepseek-v3.2",  # model参数，您可按需更换模型参数
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "介绍下你自己"},
    ]
)

print(response.choices[0].message.content)

模型回复预览：

你好！我是DeepSeek，由深度求索公司创造的AI助手，很高兴认识你！✨
让我简单介绍一下自己：
我的能力特点：
·拥有广泛的知识储备（知识截止到2024年7月）
·纯文本对话模型，擅长各种文字交流和分析
·支持文件上传功能——可以处理图像、txt、pdf、ppt、word、excel等文件，并从中读取文字信息
·支持联网搜索（需要你在Web/App手动点开联网搜索按键）
·完全免费使用，没有任何收费计划
我的特色：
·上下文长度达128K，能处理很长的对话
·回复风格热情细腻，希望给你温暖的交流体验
·可以通过官方应用商店下载App使用
虽然我不能：
·进行语音对话
·生成图片或视频
·实时识别多模态信息
但我会尽我所能用文字为你提供帮助！无论是学习、工作、生活中的问题，还是想要聊天谈心，我都很乐意陪伴你。
有什么我可以为你做的吗？

下一步操作

现在您已完成首次MaaS服务API调用，可探索MaaS服务更多模型能力：

  • 查看更多模型：本章节示例代码以DeepSeek-V3.2模型为例，MaaS还支持DeepSeek、千问等更多第三方模型，支持的模型及其对应的API参考请见API调用规范。
  • 在线体验大模型：如果你想通过对话框与大模型互动，请前往模型体验页面进行模型体验。
  • 部署大模型：MaaS支持部署预置模型或自定义模型，获得资源独享的推理服务，详情请见部署模型服务。
  • 零代码调优大模型：MaaS提供零代码大模型调优功能，仅需提供数据集即可实现模型调优，详情请见模型调优。

常见问题

  • 创建API Key后需要等待多久才能生效？

    MaaS API Key在创建后不会立即生效，通常需要等待几分钟才能生效。

  • MaaS调用大模型API如何计费？

    不同模型计费方式有所区别，详情请见模型服务价格。

相关文档