跳转至

快速开始

在调用模型之前,请先完成以下步骤:

  1. 注册并登录 Magik Compute 账号
  2. 选择模型并查看 API 调用示例
  3. 创建 API Key
  4. 配置 Base URL: https://api.magikcloud.cn/v1
  5. 选择 API 调用格式
  6. 调用模型 API
  7. 查看模型使用情况

全部模型

按输入/输出模态分类。数据来源:“全部模型”页面 整理时间:2026-09-15

一、文本生成(文本 → 文本)

序号 模型名称
1 GLM-5.3
2 GLM-5.2
3 GLM-5.1
4 GLM-5
5 DeepSeek-V4-Flash-0731
6 DeepSeek-V4-Pro
7 DeepSeek-V4-Pro-0813
8 DeepSeek-V4-Flash
9 DeepSeek-V3.2
10 Hy4
11 Hy3
12 MiniMax-M2.5
13 Qwen3-Coder-Next
14 auto (仅文本输入/文本输出,不支持图片)

二、图像与视频 —— 理解(图片 / 视频 / 文本 → 文本)

序号 模型名称
1 GLM-5.3-Flash
2 Kimi-K3
3 Kimi-K2.7-Code
4 Kimi-K2.6
5 MiniMax-M3
6 Qwen3.5-397B-A17B
7 Qwen3.5-27B
8 Qwen3.5-35B-A3B

不在以上两类 —— 视频生成(文本 / 图片 / 音频 / 视频 → 视频)

序号 模型名称
1 Doubao-Seedance-2-0-260128
2 Doubao-Seedance-2-5-260628

共识别 24 个模型 —— 文本生成 14 个,多模态理解 8 个,视频生成 2 个

备注

  • auto 是自动路由模型:仅支持文本输入 / 文本输出,不支持图片输入。
  • DeepSeek-V3.2、Qwen3-Coder-Next 和 Qwen3.5-27B 的模态标签在截图中被价格弹窗部分遮挡,已根据其模型家族归类。
  • 左侧列有一张卡片(输入 ¥0.8 / 输出 ¥6.4 每百万 tokens)被弹窗完全遮挡,无法识别。

1. 注册并登录 Magik Compute 账号

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

登录后进入模型广场


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

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

模型详情页

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

3. 创建 API Key

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

API Key 管理界面

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

创建 API KEY 对话框

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


4. 配置 Base URL

所有模型 API 请求均通过统一的 Base URL 发起:

https://api.magikcloud.cn/v1

使用 curl 直接请求时,将 Base URL 与具体接口路径拼接即可,例如 https://api.magikcloud.cn/v1/chat/completions。若通过 SDK 在程序中调用,则将该地址配置为客户端的 base_url,例如:

from openai import OpenAI

client = OpenAI(
    api_key="${API_KEY}",
    base_url="https://api.magikcloud.cn/v1"
)

5. 选择 API 调用格式

MagikCloud 支持以下三种 API 格式,请根据你的应用或开发框架选择对应的 API 格式:

  • Chat Completions(/chat/completions)—— 推荐。兼容 OpenAI Chat Completions 协议,绝大多数模型与开发框架默认使用该格式。
  • Anthropic Messages(/messages)—— 兼容 Anthropic Messages 协议,适合基于 Anthropic SDK 开发的应用。
  • Responses(/responses)—— 兼容 OpenAI Responses 协议,适合需要内置工具编排等能力的应用。

三种格式仅在请求路径和请求体结构上有所差异,鉴权方式相同,均在请求头中携带 Authorization: Bearer ${API_KEY}。


6. 调用模型 API

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

在模型详情页选择 API Key

请前往模型对应的官方页面或者上方模型表格,复制准确的模型名称(Model Name),并将其填写到 API 请求中的 model 参数。模型名称需与列表中完全一致,否则请求会报错。

以 Chat Completions 格式为例,拷贝页面下方提供的 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 等示例。以 Python 为例:

from openai import OpenAI

client = OpenAI(
    api_key="${API_KEY}",
    base_url="https://api.magikcloud.cn/v1"
)

response = client.chat.completions.create(
    model="${ENDPOINT}",  # 替换为模型表格中的模型名称
    messages=[{"role": "user", "content": "Please give a travel plan"}],
    max_tokens=512,
    stream=True,
)

for chunk in response:
    print(chunk.choices[0].delta.content, end="")

7. 查看模型使用情况

调用模型后,进入 Usage(用量统计) 页面,即可查看模型的使用统计,包括 Token 使用量等相关数据。

Usage 用量统计页面

用量数据支持按时间范围、模型、API Key 等维度筛选,可用于监控调用量与核对账单。