⌁ Guides

Cline

Add Gondola as an OpenAI Compatible provider in Cline and run any Venice model, paid per request in USDC on Base.

Create an API key

Sign in with your Base wallet at /keys and mint a Gondola API key. Keys start with gnd_. It authenticates every request and each call is charged in USDC against your Gondola balance.

Top up USDC on Base once at /wallet. The same balance powers the browser chat and every tool you connect.

Point Cline at Gondola

Open the Cline settings (the gear icon in the Cline panel) and set the API Provider to OpenAI Compatible. Fill in the Base URL, API Key, and Model fields. Paste the key raw, with no Bearer prefix (Cline adds it).

values to enter

API Provider:  OpenAI Compatible
Base URL:      https://api.gondola-ai.com/v1
API Key:       gnd_live_xxxx
Model:         claude-sonnet-5   (or any id from /v1/models)

In the Model Configuration section, set a real Context Window and Max Output Tokens (see step 3 for where the numbers come from), and enable Computer Use if you want Cline to take agentic actions.

Base URL gotcha

Use api.gondola-ai.com/v1 and stop there. Do not append /chat/completions; Cline adds the path itself.

Pick a model

Gondola serves the full Venice catalog. Model ids must be typed exactly as the catalog lists them, so pull the live list:

shell

curl https://api.gondola-ai.com/v1/models

Each entry includes context_length and max_completion_tokens. Copy those into Cline's Context Window and Max Output Tokens fields. Example ids today include claude-sonnet-5 and qwen3-coder-480b-a35b-instruct-turbo, but always confirm against the live list, since the catalog changes.

Notes and troubleshooting

Set the context window

If you leave the Context Window at a placeholder, Cline's auto-condense math breaks and it will truncate or re-summarize at the wrong point. Use the real context_length from the models list.

Streaming is always on

Cline has no streaming toggle and always streams, which Gondola supports. There is nothing to configure here.

The Input Price and Output Price fields are display-only cost estimates (dollars per million tokens). They do not change what you are billed; the real price is the live marketplace rate. If a request returns insufficient balance, top up at /wallet.

Keep going

All setup guides →Cursor guide →Continue guide →Live prices →