Integration guideOpenAI-compatible

Use a model with Roo Code through IteraCompute.

Run coding agents in your editor.

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.

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: qwen/qwen3.8-27b
Context window: 32768
Supports images: Yes

Test the connection

cURL · Chat Completions

# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Hi"}],"max_tokens":64}'

This sends one short request capped at 64 output tokens. Reasoning models may use that budget before returning visible text; increase it if needed. This checks API connectivity, then send a prompt in your tool to check its configuration.

Selected model capabilities

These are API capabilities of the selected model. 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

Check the key, account balance and model permissions. Restart the tool after changing environment variables.

404 / Wrong endpoint

Use the exact Model ID and keep /v1 in the base URL. Select Chat Completions when the tool offers a Responses API option.

400 / Model options

Match context, image support, tool calls and reasoning parameters to the selected model. Aider may need explicit model metadata or edit-format settings for an unfamiliar model.

429 / Request limits

Reduce concurrency or retry with backoff. For predictable production capacity, explore Reserved Inference.

Keep exploring

Start building with Roo Code.

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

Get API Key View Docs