OpenAI-compatible

Use a model with Aider through IteraCompute.

Pair program with open models.

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

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/Auto

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.

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

Model not recognized

Use aider --model openai/Auto 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 concurrency. Honor Retry-After and avoid parallel retries. Free Auto has no automatic paid overage; other models use their published prices.

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

Aider configuration reference →

Start building with Aider.

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