Quickstart
Nach dem Erstellen eines API-Schlüssels im Dashboard setzen Sie ihn als Umgebungsvariable und senden den ersten Request:
curl https://api.voltapi.ai/v1/chat/completions \
-H "Authorization: Bearer $VOLT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "Ahoj!"}]
}'Authentifizierung
Jeder Request benötigt den Header Authorization: Bearer `YOUR_API_KEY`. Schlüssel werden im Dashboard erzeugt und können auf Projekte oder Modelle eingeschränkt werden.
OpenAI SDK
Für das OpenAI SDK genügt es, baseURL auf https://api.voltapi.ai/v1 umzuschreiben und den VoltAPI-Schlüssel zu nutzen. Keine weiteren Code-Änderungen.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.VOLT_API_KEY,
baseURL: "https://api.voltapi.ai/v1"
});
const r = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "Hello" }]
});Anthropic SDK
Das Anthropic SDK funktioniert identisch über den OpenAI-kompatiblen Endpunkt. Claude 4 Modelle sind unter ihren nativen IDs verfügbar (claude-opus-4, claude-sonnet-4, claude-haiku-4).
Fehlercodes
VoltAPI gibt Standard-HTTP-Codes zurück: 401 (ungültiger Schlüssel), 402 (Quota erschöpft), 429 (Rate Limit), 503 (Modell vorübergehend nicht verfügbar — wir leiten automatisch um).