Skip to main content
Early accessGnani Evon v3.5 is now available as an API to early access registrants.
This page takes you from no key to a working reply. You need a terminal, and Python 3 or Node.js if you want to use an SDK. For Python you can use OpenAI’s SDK, or Gnani’s own gnani-vachana SDK, which has a sync and an async client (install it with pip install "gnani-vachana[llm]"). See the Python SDK page.
1

Get an API key

Create a key in the Gnani API dashboard. The key must have access to the LLM API; a key without it gets 403 SCOPE_NOT_ALLOWED.
2

Set the key as an environment variable

Keep the key out of your code. The examples on this page read it from GNANI_API_KEY:
3

Send a message

The model thinks before it answers, by default. Thinking counts toward max_tokens, which is 1,024 on Free and Pay-as-you-go plans, so a first request with thinking on can come back with empty content and finish_reason: "length". These examples send "reasoning_effort": "none" to turn thinking off. To turn it on, leave the field out. See Thinking.
4

Read the reply

The answer is in choices[0].message.content. usage shows the tokens the request used.
Without reasoning_effort, the model’s thinking comes back in message.reasoning, apart from the answer. It counts as output tokens.

If something goes wrong

All error codes are on the Errors page.

Pick settings for your use case

Choose what you are building to see the settings to start with, and a request you can copy.

Next steps

Chat Completions reference

Every request parameter, the response, and code examples.

Streaming

Show the reply word by word while the model writes it.

Thinking

When to turn thinking on, and what it costs.

Migrating from OpenAI

Move existing OpenAI code by changing two lines.