快速开始

在调用模型之前，您需要完成以下几个步骤：

注册并登录 Magik Compute 账号
选择模型并查看调用示例
创建 API Key
调用模型接口

1. 注册并登录 Magik Compute 账号

访问 Magik Compute 官网并点击右上角"登录"。根据页面提示使用账号密码或验证码完成登录。登录成功后将进入模型广场。

图 1 登录后进入模型广场

2. 选择模型并查看调用示例

在"模型广场"查看当前可用模型。每张模型卡片通常会显示模型名称、计费信息和核心能力。点击模型卡片后，可进入模型详情页，查看模型介绍、能力说明、价格以及 API 调用示例。

模型名称：调用时需要填写在 model 字段中，例如 DeepSeek-V4-Pro。
模型能力：可确认模型是否支持文本、图片、工具调用、深度思考等能力。
价格信息：按输入 Token、缓存命中 Token、输出 Token 等维度计费。

3. 创建 API Key

从页面顶部导航点击 API KEY，进入 API Key 管理界面。若当前没有任何 API Key，列表会为空。点击右上角的 创建 API KEY 按钮，新建一个密钥。

弹出的对话框标题为"创建 API KEY"，需要输入名称（例如"我的 API KEY"）。名称仅用于区分不同密钥，可根据个人喜好填写。点击 OK 即可生成 API Key。生成后会在列表中显示名称、密钥 ID、创建时间等信息，用户可复制密钥值用于调用接口。

若已有 API Key，可跳过这一步，直接在模型详情页选择现有 Key 进行测试。

4. 调用模型接口

在模型详情页选择刚刚创建的 API Key，点击下拉框选择即可。

拷贝页面下方提供的 curl 示例，命令类似：

curl --request POST \
  --url https://api.magikcloud.cn/v1/chat/completions \
  --header 'Authorization: Bearer ${API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "${ENDPOINT}",
    "messages": [{
        "role": "user",
        "content": "Please give a travel plan"
    }],
    "stream": true,
    "max_tokens": 512,
    "stream_options":{"include_usage": true},
    "chat_template_kwargs": {"thinking": true},
    "tools": [
        {
            "function": {
                "description": "文搜工具",
                "name": "web_search",
                "parameters": {
                    "properties": {
                        "query": {
                            "description": "用于文本检索的子任务查询",
                            "type": "string"
                        },
                        "timeliness": {
                            "description": "时间线参数设置",
                            "type": "integer"
                        }
                    },
                    "type": "object"
                }
            },
            "type": "function"
        }
    ]
  }'

发送请求后即可获得模型回复。

若希望在程序中调用，可查看 Python、JavaScript、Golang 等示例

5. 在线体验模型能力

进入在线体验页面，左侧栏可选择语言模型、文生图模型和图生图模型，选择相应模型即可开始实时体验。输入相关参数及 prompt ，点击“运行”按钮，即可看到模型生成的结果。

6. 查看模型调用数据

进入用量统计页面可查看不同模型的用量和性能数据。