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
Create an account
Sign up on solvena.si and verify your email.
- 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
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
SOLVENA_API_KEY=API_KEYHighlighted parts are the values you replace with your own.
Connection
| Base URL | https://api.solvena.si/v1 |
|---|---|
| Authentication | Authorization: Bearer API_KEY |
| Protocol | OpenAI Chat Completions (v1) |
| Model | solvena-lime |
| Client timeout | 600 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.
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
Chat
The main endpoint that answers messages.
Embeddings
Turns text into vectors for search and similarity.
Audio
Audio-related endpoints.
Models
Lists the models you can use.
Status
Reports the service status.
- Every endpoint, parameter and sample responseFull API reference
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.