Prerequisites
- A GMI Cloud account at console.gmicloud.ai
- TRAE installed
- About 5 minutes
Step 1. Get your GMI API key
- Sign in to console.gmicloud.ai.
- Open API Keys → Create API Key.
- Copy the key now, it won’t be shown again.
Step 2. Open TRAE’s model settings
In TRAE, open Settings → Models. The model management panel lists TRAE’s built-in models and any custom models you have added.Step 3. Add GMI Cloud as a custom model
- Click Add Model.
- In the Add Model window, select Custom Model instead of a preset provider.
- Fill in the fields. Use the first table for most models and the second for Claude models.
Claude models:
- Optional: expand Advanced Settings. Turn on Image Input Support if the model accepts images. Leave Model Series on Default. Context Window and Tool Call Rounds can stay empty, TRAE fills in its own defaults.
- Click Add Model.
zai-org/GLM-5.1-FP8, moonshotai/kimi-k2.7-code, or deepseek-ai/DeepSeek-V4-Pro.
Browse model IDs in the Text models catalog.
Step 4. Use it
Click the model name in the lower-right corner of the chat input box and pick your GMI model. Send a quick prompt to confirm the connection:Recommended models for TRAE
Agentic coding leans on tool calling, so pick catalog models with function-calling support. A good starting set:
Add each one as its own entry in Step 3, then switch between them from the picker per task.
Tips
- Bad model name. If a request 404s, the model ID is wrong. GMI model IDs always include the provider prefix (e.g.
openai/gpt-5.5, notgpt-5.5). Copy the ID exactly from the catalog page. - Wrong path. A 404 with a correct model ID usually means the Full URL switch doesn’t match the URL you entered. With the switch off, use the base URL from the table. With it on, enter the full path:
https://api.gmi-serving.com/v1/chat/completionsfor OpenAI Chat Completions, orhttps://api.gmi-serving.com/v1/messagesfor Anthropic Messages. - 401 Unauthorized. The API Key field holds something other than a GMI key, or the key was revoked. Create a fresh one in the GMI console and paste it into the entry.
- Claude returns 400 about temperature and top_p. The Claude model was added under
OpenAI Chat Completions. Claude accepts only one of the two sampling settings, so add Claude models with theAnthropic Messagesformat instead. - One entry per model. TRAE stores each custom model separately, so three GMI models means three passes through Step 3 with the same key.
- Mixing providers. TRAE’s built-in models stay available alongside your GMI entries. Only the entries you added route to GMI.
- Long agent runs. If TRAE stops mid-task on a large refactor, raise Tool Call Rounds in Advanced Settings.
Next steps
- Try Cursor, Claude Code, or Codex with the same GMI account.
- TRAE docs: Built-in models & custom models
- Stuck? Email support@gmicloud.ai.