OpenAI-compatible

Free Auto in Roo Code

Run coding agents in your editor.

IteraCompute is built into Cline and OpenCode, where you can select it directly. For Roo Code, use the OpenAI Compatible setup below.

The free promotion ends at 00:00 Pacific Time on November 24, 2026. Users with positive net recharge completed before this cutoff retain their existing free tier. Afterward, shared free Auto is limited to these users and users with a currently effective plan. Later recharges do not grant or upgrade free benefits. Plan Auto tokens and monthly shared free benefits are separate allowances.

Connect in three steps

1. Create an API key

Create or sign in to your IteraCompute account, then create a key in the Console.

2. Configure the base URL

Choose OpenAI Compatible and enter the connection fields. Set the context window and image support for your selected model.

3. Select the model

Use the exact API Model ID for your chosen model. Check its context and capabilities before enabling agent or vision features.

Choose your model

Auto examples use the Free tier: 30M tokens/month and 128K (131072) total context, including input plus requested maximum output. Maximum output is 8192 tokens.

A cumulative net top-up of $10 unlocks Starter: 100M tokens/month, 128K (131072) context and queue priority. At $50, Pro unlocks 300M tokens/month, queue priority and the model maximum of 256K (262144) context. Top-ups remain spendable API balance; these are not monthly fees.

Example configuration

Keep API keys in your server environment or tool credential store. Replace the example key field with your own key where applicable.

Connection settings · enter each field in the tool
API Provider: OpenAI Compatible
Base URL: https://api.iteracompute.com/v1
API Key: YOUR_ITERACOMPUTE_API_KEY
Model ID: Auto
Context window: 131072
Supports images: No

Version and verification

Result
Local example tests passed.

Find each field in Roo Code

Roo fieldWhere to find itExample value
API ProviderSettingsOpenAI Compatible
Base URLBelow API Providerhttps://api.iteracompute.com/v1
API KeyBelow Base URLYOUR_ITERACOMPUTE_API_KEY
Model / Model IDBelow the connection fieldsAuto
Context WindowExpand Model Configuration131072
Max Output TokensModel Configuration8192
Image SupportModel ConfigurationNo
Computer UseModel ConfigurationNo

Open the Roo Code sidebar in VS Code, click its Settings gear, then select OpenAI Compatible under API Provider. Expand Model Configuration below the model selector. Field wording may vary by version. These values use free Auto: 131072 total tokens, including up to 8192 output tokens. Input Price and Output Price, if shown, are both 0 for this model.

Test the connection

cURL · Chat Completions
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Auto","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

Check that choices[0].message.content contains visible text; HTTP 200 alone is insufficient. Reasoning may consume the output budget. For free Auto, use the first free call example to disable thinking, then send a prompt inside your tool.

Complete a small coding task

Open an empty folder in VS Code with Node.js 22 or newer installed. In Roo Code, select Code mode and the configured IteraCompute provider, then send this prompt. Review the proposed file writes and approve the test command when Roo asks.

Roo Code · task prompt
In this empty workspace, create slugify.mjs exporting slugify(text).
Trim whitespace, lowercase the text, replace each run of non-ASCII-alphanumeric characters with one hyphen, and strip leading/trailing hyphens.
Create slugify.test.mjs with node:test and node:assert/strict for these four cases:
"Hello Roo Code" -> "hello-roo-code"
"  IteraCompute API  " -> "iteracompute-api"
"Hello,   World!!" -> "hello-world"
"---" -> ""
Run node --test slugify.test.mjs. Fix failures, then complete the task with the files changed and the actual test result. Do not install dependencies.

Reference files for the completed task

slugify.mjs
export function slugify(text) {
  return text.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
}
slugify.test.mjs
import test from 'node:test';
import assert from 'node:assert/strict';
import { slugify } from './slugify.mjs';

for (const [input, expected] of [
  ['Hello Roo Code', 'hello-roo-code'],
  ['  IteraCompute API  ', 'iteracompute-api'],
  ['Hello,   World!!', 'hello-world'],
  ['---', ''],
]) {
  test(JSON.stringify(input), () => assert.equal(slugify(input), expected));
}
node --test slugify.test.mjs · result summary
# tests 4
# pass 4
# fail 0

The local reference tests pass. Verify the actual file changes and test result in your Roo Code task.

Selected model capabilities

Capabilities describe the IteraCompute API. Feature availability in your workflow also depends on the tool and its settings; reasoning controls vary by model.

  • Chat CompletionsSupported
  • Tool callingSupported
  • ReasoningSupported
  • Image inputSupported
  • StreamingSupported

Troubleshooting

401 / 403 · Active provider

In Roo Settings, check the API Key for the provider configuration selected in your current task, including model permission. Save it and retry. Free Auto requires no balance or card.

404 · Base URL / Model ID

In Roo Settings, choose OpenAI Compatible, keep /v1 in Base URL and enter Auto as the Model ID without an openai/ prefix. Use the Chat Completions endpoint.

400 / Tools not executed

Roo requires native tool calling. Check Model Configuration: free Auto context is 131072 and max output is 8192. For file edits, use Code mode and inspect pending tool approvals in the task timeline; a completed chat reply alone is insufficient.

429 / Empty reply

Check monthly usage and concurrency in the IteraCompute Console and honor Retry-After before retrying the Roo task. For empty replies, run the first free API call separately to verify visible content, then retry a small Code-mode task.

401 / 403: check the key and model permission. Free Auto requires no balance or card. For paid models, also check available balance.

Roo Code configuration reference →

Start building with Roo Code.

Connect your key, choose a model and send your first request.