Rychlý start
Po vytvoření API klíče v Dashboardu jej nastavte jako environment variable a udělejte první 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!"}]
}'Autentizace
Všechny requesty potřebují hlavičku Authorization: Bearer `YOUR_API_KEY`. Klíče se generují v Dashboardu a mohou být scoped na konkrétní projekty nebo modely.
OpenAI SDK
Pro OpenAI SDK stačí přepsat baseURL na https://api.voltapi.ai/v1 a použít VoltAPI klíč. Žádné další změny v kódu.
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
Anthropic SDK funguje identicky přes OpenAI-compatible endpoint. Modely Claude 4 jsou dostupné pod jejich nativními ID (claude-opus-4, claude-sonnet-4, claude-haiku-4).
Chybové kódy
VoltAPI vrací standardní HTTP kódy: 401 (neplatný klíč), 402 (vyčerpaná kvóta), 429 (rate limit), 503 (model dočasně nedostupný — automaticky přesměrujeme).