快速入门

本指南将帮助您开始使用MaaS API。我们将引导您创建一个简单的AI模型

步骤1：登录控制台获取访问密钥

以您的帐户登录Cloudsway控制台后，您可以参考下图找到您的访问密钥AK信息，AK是用于访问MaaS API的凭证，请您妥善保存

登录页面在这里。

从用户配置文件菜单获取您的访问密钥。

然后您可以看到您的访问密钥。

步骤2：访问MaaS API查看资源

目前未开放模型的自助创建，由后台同事创建完毕，您可以导航到MaaS API：

即可在模型列表页看到模型生成对应的endpoint：

步骤3：完成调用

从控制台获取到的AK信息 和endpoint信息去完成调用

        curl -X POST 'https://genaiapi.cloudsway.net/v1/ai/{Your Endpoint}/chat/completions' -H 'Authorization: Bearer YOU_API_KEY' -H 'Content-Type: application/json' --data '{
        "model": "MaaS_DS_V3.1_20250821",
        "messages": [
            {
                "role": "user",
                "content": "hello"
            }
            ]
        }'

返回以下结果：

        {
        "choices": [
            {
                "finish_reason": "stop",
                "index": 0,
                "logprobs": null,
                "messages": [
                {
                    "role": "assistant",
                    "content": "I'm doing well, thank you for asking. How can I help you today?"
                }
                ]
            }
        ],
        "created": 1632345678,
        "model": "deepseek—3.1",
        "object": null,
        "system_fingerprint": null,
        "usage": {
            "completion_tokens": 100,
            "prompt_tokens": 20,
            "total_tokens": 120
        }
        }

步骤4：配置内容过滤器

登陆 MaaSAPI控制台,根据业务场景，以excel/csv格式上传敏感词，并绑定endpoint以生效。平台会根据上传的敏感词进行输入输出的过滤。

步骤5：控制台查看审计日志

登陆 MaaSAPI控制台,查看审计日志

步骤6：控制台查看监控数据

登陆 MaaSAPI控制台,查看用量，时延等数据

步骤7：管理workspace

若您存在多个业务部门，除了对账单拆分有需求外，还希望资源隔离。您可以为多个业务分别创建对应的workspace，将资源分别配置到指定的workspace中这样达到资源隔离。详细操作您可以参考 Workspace操作指引