Documentation

Integration guide

Solvena SI is an OpenAI-compatible API. You use the official openai SDK; only the base URL and the API key change. This page walks you to your first request; every endpoint is in the API reference.

Get started in 3 steps

  1. 1

    Create an account

    Sign up on solvena.si and verify your email.

  2. 2

    Generate an API key

    In the console, create a key starting with sk- on the API keys page. It is shown only once.

  3. 3

    Put the key in an environment variable

    Never hard-code the key; read it from the SOLVENA_API_KEY environment variable.

Where does the API key go?

Wherever the samples say API_KEY, use the key starting with sk- that you created in the console. Keep it on the server; never ship it in browser or mobile app code.

.env file
# .env
SOLVENA_API_KEY=API_KEY

Highlighted parts are the values you replace with your own.

Connection

Base URLhttps://api.solvena.si/v1
AuthenticationAuthorization: Bearer API_KEY
ProtocolOpenAI Chat Completions (v1)
Modelsolvena-lime
Client timeout600 s recommended

The old address https://api.solvena.io/v1 keeps working the same way during the transition.

First request

The same request three ways. Each reads the key from the SOLVENA_API_KEY environment variable.

curl https://api.solvena.si/v1/chat/completions \
  -H "Authorization: Bearer $SOLVENA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "solvena-lime",
    "messages": [{"role": "user", "content": "Hello! Can you introduce yourself in one sentence?"}]
  }'

Let your coding assistant do it

Paste the text below into a coding assistant such as Cursor, Claude Code, GitHub Copilot or ChatGPT. It adds the integration in a way that fits your project. You enter the API_KEY value yourself.

Prompt
Add a Solvena SI API integration to my project.

Connection details:
- Base URL: https://api.solvena.si/v1
- Protocol: OpenAI Chat Completions (v1) compatible. Use the official "openai" SDK; only base_url and api_key change.
- Authentication: Authorization: Bearer API_KEY
- Model: solvena-lime
- Client timeout: 600 seconds
- Full API reference: https://api.solvena.si

Requirements:
1. Read the API key from the SOLVENA_API_KEY environment variable. Never hard-code it or put it in browser or mobile client code.
2. Add the line SOLVENA_API_KEY=API_KEY to .env.example.
3. Write one helper function that takes a list of messages, sends it to the solvena-lime model and returns the reply text.
4. Handle invalid key (401), rate limit (429) and timeout errors with clear messages.
5. Show the package install command and a short usage example.

I will enter the API_KEY value myself; it starts with sk-.

The prompt does not contain your API key; define the key only in your own environment.

Models

  • solvena-limeThe general-purpose default model.
  • solvena-lime-fastAn alias of solvena-lime for short, speed-first tasks.
  • solvena-lime-thinkAn alias of solvena-lime for tasks that need more thinking.

The models your key can use are listed in the console and in the /v1/models response.

What the API offers

Tips

  • Keep the key on the server; client apps should call through your own backend.
  • Create a separate key per environment (development, production); revoke from the console when needed.
  • Set the client timeout to 600 seconds for long answers.
  • Track usage and limits on the Usage and Limits pages of the console.

Got your key?

If you don't have an account yet, you can create one in a few minutes.

Sign up →