Tokenholvi
API-dokumentaatio

OpenAI-yhteensopiva /v1

Jokainen OpenAI SDK toimii suoraan. Vaihda base_url osoitteeseen https://api.tokenholvi.fi/v1 ja käytä Tokenholvi API-avainta.

Autentikointi

Lähetä API-avain HTTP-otsakkeessa Authorization: Bearer THV_KEY. Avaimet luodaan dashboardista ja näkyvät vain kerran.

Chat completions

curl
curl https://api.tokenholvi.fi/v1/chat/completions \
  -H "Authorization: Bearer $THV_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large-eu",
    "messages": [
      {"role": "user", "content": "Mikä on EU AI Act?"}
    ]
  }'
Python (OpenAI SDK)
from openai import OpenAI

client = OpenAI(
    base_url="https://api.tokenholvi.fi/v1",
    api_key=os.environ["THV_KEY"],
)

resp = client.chat.completions.create(
    model="silo-poro-34b",
    messages=[{"role": "user", "content": "Tervehdi suomeksi"}],
)
print(resp.choices[0].message.content)
JavaScript / TypeScript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.tokenholvi.fi/v1",
  apiKey: process.env.THV_KEY!,
});

const resp = await client.chat.completions.create({
  model: "self-llama-3.3-70b",
  messages: [{ role: "user", content: "Hei!" }],
});
console.log(resp.choices[0].message.content);

Mallien listaus

GET /v1/models
curl https://api.tokenholvi.fi/v1/models -H "Authorization: Bearer $THV_KEY"

Streaming

Aseta stream: true. Vastaus on SSE-virta OpenAI-yhteensopivassa muodossa.

Virhekoodit

  • 401 — Avain puuttuu tai virheellinen
  • 403 — Mallia ei ole sallittu avaimelle
  • 429 — Kiintiö täynnä
  • 503 — Tarjoaja ei vastaa, kokeile toista mallia