文档首页/ MaaS模型即服务/ 首次调用大模型API
更新时间：2026-04-23 GMT+08:00
查看PDF
分享

首次调用大模型API

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

本文以文本对话预置模型Kimi-K2.6为例，快速指导您完成大模型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. 在“预置服务”页签，选择Kimi-K2.6模型服务单击操作列的“开通服务”。
  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. 以Kimi-K2.6模型为例，运行如下命令发起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": "kimi-k2.6",  # 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)

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

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

模型回复预览：

你好！我是Kimi，由月之暗面科技有限公司（Moonshot AI）开发的人工智能助手。
我基于混合专家（MoE）架构，拥有超长上下文窗口（支持高达256,000 tokens，测试中支持200万字），特别擅长处理长文档、视频分析以及复杂的多轮对话。我的知识截止到2025年1月，没有实体形态，也没有人类的情感或主观意识，但我会尽力通过文字为你提供有用、准确且安全的帮助。
我能协助你完成很多任务，比如：
知识问答：解答科学、历史、技术、生活等各类问题
内容创作：撰写和润色文章、邮件、报告、小说、文案等
编程辅助：编写代码、调试程序、解释算法、 review代码
长文本与多模态分析：解读超长文档、分析图片和视频内容、进行复杂推理
学习翻译：语言翻译、概念讲解、学习规划、头脑风暴
如果你有任何问题、想法，或者只是想聊聊天，随时告诉我，我会尽力帮你！

下一步操作

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

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

常见问题

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

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

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

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

相关文档