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.
Choose your model
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-27bVersion and verification
Configuration reference · reviewed 2026-10-15. A reproducible end-to-end tool test has not been recorded here. Record your installed version and test date when running the steps below.
Success criterion
Ask Aider to change one small tracked file. Check the resulting diff and a passing test command.
Record the installed version
aider --versionTest the configured tool itself after the API check below. An HTTP 200 or a cURL result alone does not verify that tool.
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":"qwen/qwen3.8-27b","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 Qwen, use the first free call example to disable thinking, then send a prompt inside your tool.
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
Model not recognized
Use aider --model openai/qwen/qwen3.8-27b and set OPENAI_API_BASE plus OPENAI_API_KEY. The openai/ prefix selects the compatible provider.
Edit format rejected
An unfamiliar model may need explicit Aider model metadata or edit-format settings. Test one small tracked file before applying broad changes.
No usable patch
Run from your repository and add the intended file. Check the actual diff and run its tests; a successful conversation is not proof of a successful patch.
429 / Request limits
Check account-wide monthly usage and TPM. Honor Retry-After and avoid parallel retries. Free Qwen has no automatic paid overage; other models use their published prices.
401 / 403: check the key and model permission. Free Qwen requires no balance or card. For paid models, also check available balance.
Start building with Aider.
Connect your key, choose a model and send your first request.