# 认证鉴权

## 简介

ModelVerse API 使用 API Key 进行认证。所有 API 请求都必须在 HTTP 请求头中包含有效的 API Key。

## 获取API Key

请访问 [ModelVerse 控制台](https://console.ucloud.cn/modelverse/experience/api-keys) 来创建和管理您的 API Key。

> 注意：请妥善保管您的 API Key，不要泄露给他人。

![API Key 页面](https://cdnv2-cache.udelivrs.com/2026/08/e27d7212a5160834f25d05c90b80e385_1785749350590.png)

## 调用地址

根据您的地理位置和访问需求，选择合适的 API 节点：

- **统一接入域名（推荐）**：无需指定具体地域。发生地域故障时，平台可将该域名切换至备用地域，您无需修改调用地址。
- **地域域名**：固定接入指定地域，不参与跨地域切换，适用于有地域偏好、网络时延或数据驻留要求的用户。

> 统一接入域名的故障切换需要一定时间生效，生效时间受 DNS 缓存影响，期间部分请求或已有连接可能受到影响。

### 统一接入域名（推荐）

| 地区 | API 域名 | 说明 |
| --- | --- | --- |
| 中国大陆 | `api.modelverse.cn` | 中国大陆统一访问入口，推荐国内用户使用 |
| 海外 | `api.umodelverse.ai` | 海外统一访问入口，推荐海外用户使用 |

### 地域域名

| 地域 | API 域名 | 说明 |
| --- | --- | --- |
| 乌兰察布 | `api-cn-wlcb.modelverse.cn` | 固定接入乌兰察布地域 |
| 上海二 | `api-cn-sh2.modelverse.cn` | 固定接入上海二地域 |
| 美国洛杉矶 | `api-us-ca.umodelverse.ai` | 海外用户推荐，数据不回国 |
| 新加坡 | `api-sg.umodelverse.ai` | 东南亚用户推荐，访问更快 |
| 法兰克福 | `api-ge-fra.umodelverse.ai` | 欧洲用户推荐，访问更快 |



## 最简调用

请将 `{api_key}` 替换为您的 API Key。`api.modelverse.cn` 可以替换为上述表格中的其它统一接入域名或地域域名。

```bash
curl --location 'https://api.modelverse.cn/v1/chat/completions' \
--header "Authorization: Bearer {api_key}" \
--header 'Content-Type: application/json' \
--data '{
    "model": "deepseek-ai/DeepSeek-R1",
    "messages": [
        {
            "role": "user",
            "content": "一句话描述UCloud这家公司。"
        }
    ]
}' | jq .
```

你可能看到的返回结果。

```
{
  "id": "0a7919c4-981e-438b-ad30-e943b96882b6",
  "object": "chat.completion",
  "created": 1763015400,
  "model": "deepseek-r1-250528",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "用中立、安全、本土化的云计算服务，专注服务中国企业数字化转型的科创板上市云服务商。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 348,
    "total_tokens": 358,
    "prompt_tokens_details": null,
    "completion_tokens_details": {
      "audio_tokens": 0,
      "reasoning_tokens": 185,
      "accepted_prediction_tokens": 0,
      "rejected_prediction_tokens": 0
    }
  },
  "system_fingerprint": "",
  "search_result": null
}
```