Set up Trae IDE

Use Trae's custom-model entry with the OpenAI-compatible endpoint.

This guide connects Trae IDE to the platform so you can reach Claude, GPT, Gemini and others with a single token. Three values are all you need: endpoint, token, model name.

Create a token (starting with sk-) in the console first and make sure the account has credit. New here? Start with your first request in 5 minutes.

Configuration

In Trae's model settings choose to add a custom / third-party model, pick the OpenAI-compatible provider type, then fill in the three values below.

Field Value
Base URL https://api.router.ai/v1
API Key your sk- token
Model name claude-sonnet-5

Verify

Before running anything complex, just say hello and check you get a reply. To test the token on its own, call the API directly:

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"hello"}]}'

A JSON response containing choices means you are connected. The call shows up in your billing records shortly after.

Troubleshooting

Some versions label the field "API endpoint" rather than "Base URL" — it is the same thing and still needs the /v1 suffix. If saving reports a connection failure, first confirm the token itself works using the command in the Verify section below, then come back to the IDE.

401

Wrong token, a stray space, or a copy that dropped the leading sk-. Copy it again in full.

404

Almost always the URL suffix. The OpenAI-compatible format needs a trailing /v1; the native Anthropic and Gemini formats must not have it. Check the table above.

402 / insufficient balance

The account is out of credit. See top-up methods.

Model not found

Model names must match the catalog exactly, including case and hyphens. Copy the exact name from the models page.

Related articles

Blog