1. Create an API key
Create or sign in to your IteraCompute account, then create a key in the Console.
Integration guideOpenAI-compatibleUse a model with Aider through IteraCompute.
Pair program with open models.
Connect in three steps
2. Configure the base URL
Set OPENAI_API_BASE and OPENAI_API_KEY. The openai/ prefix tells Aider to use its OpenAI-compatible provider.
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.
Shell · run from your project
export OPENAI_API_BASE="https://api.iteracompute.com/v1"
export OPENAI_API_KEY="$ITERACOMPUTE_API_KEY"
aider --model openai/qwen/qwen3.8-27bTest 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.
Start building with Aider.
Connect your key, choose a model and send your first request.