Quickstart
Después de crear una API key en el Dashboard, configúrala como variable de entorno y haz tu primer 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!"}]
}'Autenticación
Toda petición necesita el header Authorization: Bearer `YOUR_API_KEY`. Las keys se generan en el Dashboard y se pueden limitar a proyectos o modelos.
OpenAI SDK
Para el SDK de OpenAI basta con cambiar baseURL a https://api.voltapi.ai/v1 y usar la VoltAPI key. Sin más cambios en el código.
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
El SDK de Anthropic funciona igual a través del endpoint compatible con OpenAI. Los modelos Claude 4 están disponibles con sus IDs nativos (claude-opus-4, claude-sonnet-4, claude-haiku-4).
Códigos de error
VoltAPI devuelve códigos HTTP estándar: 401 (key inválida), 402 (cuota agotada), 429 (rate limit), 503 (modelo no disponible — lo redirigimos automáticamente).