# Authentication and Authorization

## Introduction

ModelVerse API uses API Key for authentication. All API requests must include a valid API Key in the HTTP request header.

## Obtain API Key

Please visit the [ModelVerse Console](https://console.scloudsg.com/modelverse/experience/api-keys) to create and manage your API Key.

> Note: Please keep your API Key secure and do not disclose it to others.

<img src="https://cdn.udelivrs.com/2026/01/6c88ab1dc86ad83e32414b31a91e2a9c_1767698734479.png" data-origin="https://cdn.udelivrs.com/2026/01/6c88ab1dc86ad83e32414b31a91e2a9c_1767698734479.png" alt="codex-model" class="medium-zoom-image" style="">

## API Endpoint


Endpoint :
```
GET https://api.umodelverse.ai/v1/models
```


## Simple API Call

Please replace `{api_key}` with your API Key.

```bash
curl --location 'https://api.umodelverse.ai/v1/chat/completions' \
--header "Authorization: Bearer {api_key}" \
--header 'Content-Type: application/json' \
--data '{
    "model": "deepseek-ai/DeepSeek-R1",
    "messages": [
        {
            "role": "user",
            "content": "Describe the company SCloud in one sentence."
        }
    ]
}' | jq .
```

An example of the returned result you might see.

```
{
  "id": "0a7919c4-981e-438b-ad30-e943b96882b6",
  "object": "chat.completion",
  "created": 1763015400,
  "model": "deepseek-r1-250528",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A Sci-Tech board-listed cloud service provider offering neutral, secure, localized cloud computing services, focusing on serving Chinese enterprises in digital transformation."
      },
      "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
}
```