文档首页/ MaaS模型即服务/ 首次调用大模型API

更新时间：2026-05-27 GMT+08:00

首次调用大模型API

MaaS支持通过API调用大模型，涵盖Python、Curl、OpenAI接入方式。

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

操作视屏

本视频以文本对话场景为例，介绍如何调用MaaS模型API。

准备账号和权限

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

获取API Key

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

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

开通预置模型服务

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

在MaaS控制台左侧导航栏，选择“模型推理 > 在线推理”。
在“预置服务”页签，选择DeepSeek-V4-Pro模型服务单击操作列的“开通服务”。
在开通预置模型服务弹框，默认已勾选待开通的模型服务，确认并勾选“我已阅读并同意上述说明，及《MaaS 服务声明》”，单击“一键开通”。
当模型服务的状态为开通，表示模型服务已开通。开通后调用以实际用量进行扣费，详情请见模型服务计费项，未使用时不会产生费用。

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

以Python、Curl、Open AI Python、Java四种语言为例，展示调用大模型API。

检查Python版本：
在终端输入如下命令查看当前计算机环境是否安装了Python和pip。
```
python -V
pip --version
```
以Windows的CMD为例：

图1 Windows查看Python版本

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

以DeepSeek-V4-Pro模型为例，运行如下命令发起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-v4-pro",  # 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-V4-Pro模型为例，运行如下命令发起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-v4-pro",
    "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-v4-pro",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "介绍下你自己"}
    ],
     "thinking": {
       "type": "enabled"
     }
  }'

检查Python版本：
在终端输入如下命令查看当前计算机环境是否安装了Python和pip。
```
python -V
pip --version
```
以Windows的CMD为例：

图2 Windows查看Python版本

如果未安装Python，请前往Python官网下载Python包并安装，Python版本需要在3.8或以上版本。
安装OpenAI Python SDK。
```
pip install --upgrade "openai>=1.0"
```

以DeepSeek-V4-Pro模型为例，运行如下命令发起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-v4-pro",  # model参数，您可按需更换模型参数
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "介绍下你自己"},
    ]
)

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

安装JDK，建议JDK版本为15+。
- Windows
  1. 前往Adoptium下载JDK安装包，安装JDK。
    方法一：安装.msi包。
    
    双击运行程序，按操作指引安装。勾选选 “Set JAVA_HOME variable” 和 “Add to PATH”，这样安装程序会自动配置好环境变量。
    
    安装过程中会提示是否安装 JRE（Java Runtime Environment），可以取消勾选，因为 JDK 已经包含了 JRE，装两个容易冲突。
    
    如若环境变量里未成功设置，则进行如下操作手动配置环境变量：
    - 新建系统变量JAVA_HOME，值为JDK的安装路径，如“C:\Java\jdk-17.0.2”。
    - 在系统变量Path中添加“%JAVA_HOME%\bin”。
    方法二：手动配置zip/tar.gz包。
    
    从 JDK官网下载安装包。解压到安装目录，比如“C:\Java\jdk-17.0.2”。右键“此电脑”“属性 > 高级系统设置 > 环境变量”：
    - 新建系统变量JAVA_HOME，值为解压路径，如“C:\Java\jdk-17.0.2”。
    - 在系统变量Path中添加“%JAVA_HOME%\bin”。
  2. 命令窗口运行以下命令验证安装。若有版本号输出，则表示安装成功。
```
java -version 或 javac -version
```
- Linux
  1. 执行以下命令安装：
```
# 更新包索引
sudo apt update

# 安装最新版本（例如 JDK 17 或 21）
sudo apt install openjdk-17-jdk
# 或安装JDK 21
sudo apt install openjdk-21-jdk
# 只安装 JRE 可替换为 openjdk-17-jre
sudo apt install openjdk-17-jre
```
  2. 配置环境变量，在 “~/.bashrc”、或“~/.zshrc”或“ /etc/profile”中添加：
```
export JAVA_HOME=你自己的JDK安装目录
export PATH=$JAVA_HOME/bin:$PATH
# 运行如下命令使配置生效
source ~/.bashrc（或对应文件）
```
  3. 命令窗口运行以下命令验证安装。若有版本号输出，则表示安装成功。
```
java -version 或 javac -version
```
- MacOS
  Homebrew（推荐）
```
brew install openjdk@17
```
  安装后 brew 会给出链接提示，执行类似：
```
sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk
```
  然后配置环境变量：
```
echo 'export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc
```
  命令窗口运行以下命令验证安装。若有版本号输出，则表示安装成功。
```
java -version 或 javac -version
```

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

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class ChatCompletionsExample {
    public static void main(String[] args) {
        // 接口地址
        String apiUrl = "https://api.modelarts-maas.com/v2/chat/completions";
        // 把MAAS_API_KEY替换成已获取的API Key
        String apiKey = "MAAS_API_KEY";
        // 替换为你要调用的模型名称，例如 "deepseek-v4-pro"
        String modelName = "deepseek-v4-pro";
        // 构造请求体
        String requestBody = String.format(
            """
                {
                    "model": "%s",
                    "messages": [
                        {"role": "system", "content": "You are a helpful assistant."},
                        {"role": "user", "content": "你好，请介绍一下自己"}
                    ]
                }""", modelName);
        // 创建 HttpClient
        HttpClient client = HttpClient.newBuilder()
                .connectTimeout(Duration.ofSeconds(10))
                .build();
        // 创建请求
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(apiUrl))
                .header("Content-Type", "application/json")
                .header("Authorization", "Bearer " + apiKey)
                .POST(HttpRequest.BodyPublishers.ofString(requestBody))
                .build();
        try {
            // 发送请求并打印结果
            HttpResponse<String> response = client.send(
                    request, HttpResponse.BodyHandlers.ofString());
            System.out.println("HTTP Status: " + response.statusCode());
            System.out.println("Response Body:\n" + response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

模型回复预览：

你好啊！很高兴认识你！
我是DeepSeek，由深度求索公司创造的AI助手。简单来说，我就是你的智能伙伴，随时准备帮你解决各种问题！
关于我的一些特点：
纯文本模型，擅长对话、写作、分析、编程等各类文本任务
支持文件上传，可以处理图像、PDF、Word、Excel、PPT等文件，从中读取文字信息
可以联网搜索（需要你在Web/App端手动点开联网按钮）
上下文长度1M，能一口气处理《三体》三部曲那么大的内容量
App端支持语音输入，交流更便捷
我的知识截止到2025年5月，会用热情、细腻的方式回答你的问题。无论是学习、工作还是日常闲聊，我都很乐意陪伴你！

有什么我可以帮你的吗？

下一步操作

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

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

常见问题

创建API Key后需要等待多久才能生效？
MaaS API Key在创建后不会立即生效，通常需要等待几分钟才能生效。
MaaS调用大模型API如何计费？
不同模型计费方式有所区别，详情请见模型服务价格。

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

云宝助手提问云社区提问

首次调用大模型API

操作视屏

准备账号和权限

获取API Key

开通预置模型服务

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

下一步操作

常见问题

相关文档

意见反馈

文档内容是否对您有帮助？