Quickstart

In fünf Minuten vom Konto zur ersten Antwort.

1. Konto und API-Key

1. Registriere dich in der Console mit E-Mail-Adresse und Passwort und stimme den AGB und der Datenschutzerklärung zu. Zahlungsdaten brauchst du dafür nicht. Danach schickt dir die Console einen Bestätigungslink per E-Mail. Neue Konten erhalten 1 € Startguthaben für unsere selbst gehosteten Modelle.
2. Öffne API-Keys und lege einen Key an. Er beginnt mit hk_live_ und wird nur einmal angezeigt. Speichere ihn sofort.
3. Lege ihn als Umgebungsvariable ab:

export OPENHIPPO_API_KEY="hk_live_..."

Unter Windows (PowerShell):

$env:OPENHIPPO_API_KEY = "hk_live_..."

Die curl-Beispiele unten sind für bash/zsh geschrieben.

2. Erster Request

Das Beispiel nutzt openhippo/gpt-oss-120b, ein selbst gehostetes Modell in Augsburg, das mit dem Startguthaben funktioniert.

curl

curl https://api.openhippo.io/v1/chat/completions \
  -H "Authorization: Bearer $OPENHIPPO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openhippo/gpt-oss-120b",
    "messages": [{"role": "user", "content": "Say hello from Augsburg."}]
  }'

Python

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.openhippo.io/v1",
    api_key=os.environ["OPENHIPPO_API_KEY"],
)

response = client.chat.completions.create(
    model="openhippo/gpt-oss-120b",
    messages=[{"role": "user", "content": "Say hello from Augsburg."}],
)
print(response.choices[0].message.content)

TypeScript

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.openhippo.io/v1",
  apiKey: process.env.OPENHIPPO_API_KEY,
});

const response = await client.chat.completions.create({
  model: "openhippo/gpt-oss-120b",
  messages: [{ role: "user", content: "Say hello from Augsburg." }],
});
console.log(response.choices[0].message.content);

Die Antwort hat das bekannte OpenAI-Format. Gekürzt, nur zur Orientierung (Platzhalter „…“):

{
  "id": "…",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "…" },
      "finish_reason": "…"
    }
  ],
  "usage": {
    "prompt_tokens": …,
    "completion_tokens": …,
    "total_tokens": …
  }
}

Der Text steht in choices[0].message.content, der Verbrauch in usage.

Fehlt der Key oder ist er falsch, kommt 401 invalid_api_key, siehe Fehler.

3. Verbrauch prüfen

Was der aktuelle Key in diesem Monat verbraucht hat:

curl https://api.openhippo.io/v1/usage \
  -H "Authorization: Bearer $OPENHIPPO_API_KEY"

Mehr dazu unter Authentifizierung & Basics.

Wie geht es weiter?

• Modelle: alle Modelle mit Preisen, Standort und § 203-Eignung.
• Chat, Streaming, Tool Calling
• Coding-Agenten: Claude Code, OpenCode, Cline.
• Partner-Modelle (z. B. aki-io/glm5.3-754b) werden nach der ersten Aufladung freigeschaltet: Prepaid & Preise.