Gonka24

Aider integration

Use Gonka24 with Aider

Run Aider through Gonka24 with a ready .aider.conf.yml, environment variables, and an OpenAI-compatible model name.

Configuration verified August 31, 2026

Connection details

Every example on this page uses the same Gonka24 OpenAI-compatible endpoint, a dashboard API key, and a live model ID.

Base URL
https://api.gonka24.com/v1
Authentication
Bearer sk-...
Model
GET /v1/models

Use a live model ID.

The catalog changes. Call GET /v1/models with your API key and copy an id from the response instead of relying on a model name in a guide.

bash
curl https://api.gonka24.com/v1/models \
  -H "Authorization: Bearer $GONKA24_API_KEY"

Ready-to-use config

.aider.conf.yml

The openai/ prefix tells Aider and LiteLLM to use the OpenAI-compatible adapter.
yaml
model: openai/<model-id-from-/v1/models>
openai-api-base: https://api.gonka24.com/v1
stream: true

.env

Aider loads .env files. Add .env to .gitignore before placing a real API key in it.
dotenv
# .env — keep this file out of git
OPENAI_API_KEY=sk-...

Set up Aider

  1. Install Aider, then create .aider.conf.yml in your repository or home directory.
  2. Create a .env file for the API key and make sure it is ignored by git.
  3. Replace the model placeholder with an exact ID returned by GET /v1/models.
  4. Run aider in the repository. Use aider --verbose if the first request fails.

What is supported

Supported

OpenAI-compatible models

Aider officially supports a custom OPENAI_API_BASE and models prefixed with openai/.
Supported

Streaming and repository edits

Aider can stream chat completions and apply the selected model's edits to the local repository.
Supported

Tool-like coding workflow

Aider's edit formats and repository map operate on top of chat completions; quality depends on the selected model.
Not included

Known model metadata

A live Gonka24 model may be unknown to Aider. Context-window and cost warnings do not mean the API connection failed.

Verify before an agent task

  1. Fetch the model list and copy an exact model ID.
  2. Send a short plain chat request through Aider.
  3. Confirm the request appears in your Gonka24 dashboard activity.
  4. Only then enable tool use, file writes, or long-running agent work.

Troubleshooting

Unknown model warning: Proceed after checking the model ID, or add local model metadata if you need accurate context and cost display.
Authentication error: Run aider --verbose and confirm OPENAI_API_KEY is loaded from the expected .env file.
404 or connection error: Use https://api.gonka24.com/v1 as openai-api-base and do not append /chat/completions.
Weak edits: Choose a stronger coding-capable model from the live catalog; API compatibility does not guarantee equal edit quality across models.

Verification sources

Checked against the product documentation below and the Gonka24 public API contract on August 31, 2026.