Cline OpenAI-compatible API setup: Base URL, API key, and model ID

Configure Cline with an OpenAI-compatible API provider. Use RutaAPI's Base URL, create an API key, choose a model ID, and troubleshoot common errors.

Quick answer

Use Cline's OpenAI Compatible provider, set the Base URL to https://api.rutaapi.com/v1, paste your RutaAPI API key, then choose a model ID that is enabled in the RutaAPI app pricing page. Verify the key works with /v1/models before using it in Cline.

Cline setup table

FieldWhat to use in Cline
API ProviderOpenAI Compatible
Base URLhttps://api.rutaapi.com/v1
API KeyYour RutaAPI API key
Model IDA model enabled in your RutaAPI app pricing page

What Cline needs When you configure Cline to use an OpenAI-compatible API provider, Cline asks for four things: an API Provider, a Base URL, an API Key, and a Model ID. All four must belong to the same provider. If you enter a Base URL from one platform and an API key from another, Cline will return a 401 error.

RutaAPI values for Cline Base URL: https://api.rutaapi.com/v1 — always include /v1. API key: Create one after signing in to RutaAPI. Model ID: Use a model ID visible in the RutaAPI app pricing page.

Cline version caveat Cline UI labels and provider behaviour can change by version. Depending on your Cline version, labels may vary slightly. Users should verify the current Cline UI in their installed version before configuring a custom provider.

RutaAPI disclaimer RutaAPI is an OpenAI-compatible API gateway. It is not an official Cline, OpenAI, Anthropic, Google or Microsoft service. Model availability and rates depend on your account configuration and upstream providers.

How to start with RutaAPI

Step 1 — Open Cline settings

Open Cline settings or preferences in your editor. Look for a provider or API configuration section.

Step 2 — Choose OpenAI Compatible as the provider

Select OpenAI Compatible from the available provider options. This tells Cline to use OpenAI-compatible request formatting.

Step 3 — Paste the RutaAPI Base URL

Enter https://api.rutaapi.com/v1 as the Base URL. Always include /v1. Do not use https://rutaapi.com, https://app.rutaapi.com, or any path ending in /chat/completions.

Step 4 — Paste your RutaAPI API key

Paste your RutaAPI API key into the API Key field. Create or copy the key from the RutaAPI dashboard at https://app.rutaapi.com. Keys are shown only once at creation — copy and store them securely.

Security: Never paste your full API key into screenshots or shared scripts. If exposed, rotate it immediately from the dashboard.

Step 5 — Enter or select a model ID

Enter a model ID that is enabled in your RutaAPI account. Check the RutaAPI app pricing page for enabled model IDs. Do not guess — always copy the exact ID from the dashboard or from /v1/models.

Step 6 — Verify or send a small test request

Before running any coding tasks, confirm end-to-end connectivity from the terminal:

A 200 response with a model list means your API key and Base URL are working. A 401 response means the key is wrong or revoked.

curl https://api.rutaapi.com/v1/models \
  -H "Authorization: Bearer YOUR_RUTAAPI_KEY"

What Cline needs

When you configure Cline to use an OpenAI-compatible API provider, Cline asks for four things:

All four must belong to the same provider. Do not mix keys or Base URLs across platforms.

RutaAPI values for Cline

Base URL: https://api.rutaapi.com/v1

API key: Create one after signing in to RutaAPI at https://app.rutaapi.com.

Model ID: Use a model ID visible in the RutaAPI app pricing page. Run GET /v1/models to see which models are enabled.

Test your RutaAPI key before using it in Cline

Before configuring Cline, verify that your API key and Base URL work together by calling /v1/models from the terminal:

curl https://api.rutaapi.com/v1/models \
  -H "Authorization: Bearer YOUR_RUTAAPI_KEY"

If the response returns a model list, your API key and Base URL are working. Use one of the returned model IDs as the Model ID in Cline.

Example OpenAI-compatible request

Once your key is verified, you can also send a chat completions request to confirm everything works end-to-end:

curl https://api.rutaapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_RUTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_ENABLED_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Say hello from RutaAPI"}
    ]
  }'

Replace YOUR_ENABLED_MODEL_ID with one of the model IDs from the /v1/models response. Do not hardcode a model name you have not verified.

How to pick a Model ID

Model IDs are returned by the GET /v1/models endpoint. Copy one of the model id values from the response and use it as the Model ID in Cline settings.

Model availability is per-account. If a model ID is not in your /v1/models response, it is not active in your account — add credits or check the app pricing page.

Common Cline setup mistakes

ProblemLikely causeFix
Cline says invalid API keyWrong key, missing Bearer, expired/disabled keyCreate a new key in RutaAPI and test /v1/models
Model not foundModel ID is not enabled or typed incorrectlyCheck app pricing page for enabled model IDs
404 or endpoint not foundWrong Base URL, missing /v1Use https://api.rutaapi.com/v1
429 rate limitToo many requests or limited routeSlow down requests or choose another enabled route/model
503 / upstream unavailableUpstream route, gateway, or provider temporarily unavailableRetry, switch model route, or check status/support

Cost and usage tracking

RutaAPI uses prepaid credits. Model pricing and enabled routes are shown in the app pricing page. Users should check usage logs and remaining balance after test calls.

View model pricing

Cline setup checklist

When RutaAPI may be a good fit

When RutaAPI may not be the right fit

Ready to test RutaAPI? Use one OpenAI-compatible base URL, prepaid credits, and API keys from the dashboard.

FAQ

What Base URL should I use for RutaAPI in Cline?

Use https://api.rutaapi.com/v1.

Which API provider should I choose in Cline?

Choose OpenAI Compatible.

Where do I get the API key?

Create or copy it after signing in to RutaAPI at https://app.rutaapi.com. Keys are shown only once at creation.

What model ID should I use?

Use a model ID enabled in your RutaAPI app pricing page. Run /v1/models to see available model IDs.

Why does Cline say model not found?

The model ID may be unavailable, disabled, or typed incorrectly. Check your enabled models in the app pricing page.

How do I test the key before using Cline?

Call GET /v1/models with your RutaAPI API key. A 200 response with a model list means the key is valid.

Is RutaAPI an official Cline provider?

No. RutaAPI is an OpenAI-compatible API gateway that can be configured through compatible provider settings. It is not an official Cline, OpenAI, Anthropic, Google or Microsoft service.

What does 401 mean in Cline?

HTTP 401 means the API key is missing, incorrect, or sent to the wrong Base URL. Verify the key and Base URL both come from RutaAPI. Run /v1/models to confirm the key is valid.

What does 403 mean in Cline?

HTTP 403 means the key exists but lacks permission. Check that your account has enough prepaid credits and that the model is enabled.

What does 404 mean in Cline?

HTTP 404 means the model ID is not recognised. Run /v1/models and use one of the returned model id values. Do not guess.

What does 429 mean in Cline?

HTTP 429 means you have hit a rate or concurrency limit. Lower the number of concurrent requests and retry.

What does 503 mean in Cline?

HTTP 503 means the provider route is temporarily unavailable. Retry, switch model route, or check status/support.