# Trae Integration Guide

Trae is an AI programming IDE developed by ByteDance that supports configuring custom models. This guide explains how to use it to call models through the UModelverse platform.

## **System Requirements**

| Platform | Requirements |
| --- | --- |
| Windows | Windows 10 or Windows 11 |
| macOS | macOS 10.15 (Catalina) or later |
| Linux | Mainstream distributions (Ubuntu, Debian, etc.) |

A network connection is required on all platforms.

## **1. Install Trae**

Go to the [Trae official website](https://www.trae.ai/) to download and install the client for your platform.

## **2. Get an API Key**

Visit the [UModelverse Console](https://console.ucloud.cn/modelverse/api) to obtain your API key. For available models, see the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform.

## **3. Add a Custom Model**

UModelverse uses the OpenAI-compatible protocol.

1.  Open the Trae chat panel, click the model selector, and choose **Add Model** / **Manage Models**.
    
2.  Select **OpenAI** or **Custom (OpenAI Compatible)** as the provider, and fill in the fields as shown below:
    

| Field | Value |
| --- | --- |
| Base URL / Model Service URL | `https://api-us-ca.umodelverse.ai/v1` |
| API Key | Your UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| Model ID / Model | One of the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform, e.g. `claude-sonnet-4-6` |

3.  After saving, select the model in the model selector to start using it.
    

## **FAQ**

### Failed to add a model or request fails?

Please check each of the following:

1.  The API Key is from the UModelverse platform, copied in full with no whitespace.
    
2.  The Base URL is `https://api-us-ca.umodelverse.ai/v1` (including the `/v1` suffix).
    
3.  The Model ID is one of the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform, with the name matching exactly.