Docs · Integrations

Cline and Roo Code with TopxAI: the OpenAI-compatible provider

2026-10-28

Set the provider to OpenAI Compatible with base URL https://ai.topxea.com/v1, a TopxAI key and a model id; or the Anthropic provider with a custom base URL.

Cline and Roo Code support OpenAI Compatible for TopxAI chat models, and Anthropic with a custom base URL for Claude. Setting names vary by extension version. The separate Jev, image and video APIs are outside this chat setup; check the compatibility table for model limits.

OpenAI Compatible

In the extension's settings:

• API Provider: OpenAI Compatible
• Base URL: https://ai.topxea.com/v1
• API Key: a TopxAI key (Auto route covers every model)
• Model ID: claude-sonnet-5-5, gpt-6.1-sol, grok-4.7, kimi-k3.1-pro or GLM-5.3-Abliterated

If shown, leave the "Azure" and "legacy format" switches off. The model ID must match the catalogue exactly; enter it manually if it is absent from the picker. Roo Code requires native tool calling, so verify the selected model supports the tool workflow you need.

Anthropic with a custom base URL

For Claude models the Anthropic provider keeps prompt caching and the Messages-specific features:

• API Provider: Anthropic
• Use custom base URL: on, https://ai.topxea.com
• API Key: the TopxAI key
• Model: claude-sonnet-5-5 or claude-opus-5-5

The base URL here is the origin without /v1; the extension appends /v1/messages.

Agent mode and cost

These tools can resend conversation history, tool definitions and file contents across turns. Prompt caching can reduce repeated-input costs on the Claude line. Cache reads and writes have separate prices for each model and route; see the current prices and worked billing example. The usage log separates cached from uncached tokens per request.

If it fails

• 401: the key is wrong or was pasted with a space. 402: the balance is empty. 403: the model id is not sold here or is not on this key's route. See Common error responses.
• The model works in curl but not in the tool: that page lists the usual causes, one per tool.

Models: claude-sonnet-5-5, gpt-6.1-sol · Models & pricing

Related

• Connect your SDK
• Create an API key and choose a route
• The model works in curl but not in my tool
• Common error responses
• Cursor with TopxAI: override the OpenAI base URL
• Continue with TopxAI: models in config.yaml
• Reading your usage log
• Claude Sonnet 5.5 API pricing
• GPT-6.1 Sol API pricing

Previous: Cursor with TopxAI: override the OpenAI base URL · Next: Continue with TopxAI: models in config.yaml

Other languages: 简体中文