Skip to content

Quickstart

This page gets you to your first AI request in 5 minutes. All you need is an API key.

What you need

  • A Qevron API key (sk-...). If you don't have one, create it from Authentication.
  • Optional: Python or Node.js (not needed for curl).

Want a more thorough setup?

This page shows the fastest path. To go from setup to production step by step, with error handling and a prod checklist, see the Integration Guide.

1. Get your API key

Create a key in the Qevron admin dashboard. A key is a string starting with sk-, for example:

sk-aBcD1234eFgH5678...

Keep your key secret

An API key is like a password. Don't put it in source code, screenshots or public repos. Store it in a server environment variable (e.g. QEVRON_API_KEY).

See Authentication for how to create a key.

2. Make your first request

The example below sends a simple question to the verinova model. Replace $QEVRON_API_KEY with your own key.

bash
curl https://app.qevron.ai/v1/chat/completions \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "verinova",
    "messages": [
      { "role": "user", "content": "Hello! Introduce yourself in one sentence." }
    ]
  }'
python
from openai import OpenAI

client = OpenAI(
    api_key="QEVRON_API_KEY",  # your own key
    base_url="https://app.qevron.ai/v1",
)

resp = client.chat.completions.create(
    model="verinova",
    messages=[
        {"role": "user", "content": "Hello! Introduce yourself in one sentence."},
    ],
)
print(resp.choices[0].message.content)
javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.QEVRON_API_KEY,
  baseURL: "https://app.qevron.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "verinova",
  messages: [
    { role: "user", content: "Hello! Introduce yourself in one sentence." },
  ],
});
console.log(resp.choices[0].message.content);

3. Read the response

Qevron returns a response in OpenAI format:

json
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1716200000,
  "model": "verinova",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! I'm an AI assistant running through Qevron."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 16,
    "total_tokens": 34
  }
}

The reply text is in choices[0].message.content. The usage field shows how many tokens you spent.

Troubleshooting your first call

SymptomLikely causeFix
401 UnauthorizedMissing/wrong keyIs Authorization: Bearer sk-... correct? Are api_key + base_url set in the SDK?
404 model_not_foundWrong model name / no accessList available names with /v1/models
Connection errorWrong base_urlhttps://app.qevron.ai/v1 (must end with /v1)
429Rate limitWait briefly and retry (see Integration Guide)

What's next?

Qevron — AI gateway. Arpanet / OpenAI / Anthropic / Gemini compatible.