Primeros pasos
Autenticación
Autentica tus peticiones con una clave de API sk-api14 enviada como token Bearer, y aprende a crearla, protegerla, limitarla y revocarla.
Cada petición a un endpoint de pago se autentica con una clave de API de api14, enviada como token Bearer en la cabecera Authorization.
Authorization: Bearer sk-api14-...
Los SDK de OpenAI añaden esta cabecera por ti a partir de la opción apiKey / api_key.
Claves de API
Crea y gestiona tus claves en Claves de API.
- Las claves empiezan por
sk-api14-y se muestran una sola vez, al crearlas. Solo se guarda un hash, así que una clave perdida no se puede recuperar: crea una nueva y revoca la antigua. - Cada clave puede tener su propio límite de peticiones por minuto, límite de gasto diario en USD y lista de modelos permitidos. Consulta Límites de tasa.
- El número de claves que puedes tener depende de tu plan: 1 en Free, 10 en Pro y más en Team y Enterprise.
- Revocar una clave tiene efecto inmediato; las peticiones que la usen devuelven
401 invalid_api_key.
Usar una clave
Guarda la clave en una variable de entorno y léela desde el código:
export API14_API_KEY="sk-api14-..."
curl https://api14.com/api/v1/chat/completions \
-H "Authorization: Bearer $API14_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "openai/gpt-5-mini", "messages": [{"role": "user", "content": "Hello"}]}'
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api14.com/api/v1",
apiKey: process.env.API14_API_KEY,
});
const result = await client.chat.completions.create({
"model": "openai/gpt-5-mini",
"messages": [
{
"role": "user",
"content": "Explain vector databases in two sentences."
}
]
});
console.log(result.choices[0].message.content);
Endpoints sin clave
Estos endpoints de catálogo de solo lectura funcionan sin autenticación:
| Endpoint | Descripción |
|---|---|
GET /models | Todos los modelos disponibles |
GET /models/{id} | Un modelo |
GET /images/models | Modelos de imagen con sus parámetros adicionales |
GET /videos/models | Modelos de vídeo con resoluciones y duraciones |
GET /embeddings/models | Modelos de embeddings |
Todo lo demás (endpoints de generación, /credits, /key, /generation y el estado de las tareas de vídeo) requiere una clave.
Errores de autenticación
Una clave ausente, mal formada o revocada devuelve:
{
"error": {
"message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
"type": "authentication_error",
"code": "invalid_api_key"
}
}
con el estado HTTP 401. Una clave restringida por su lista de modelos permitidos devuelve 403 model_not_allowed para los demás modelos. Consulta Errores.
Mantén tus claves seguras
- Nunca pongas una clave en el código de un navegador o de una app móvil: cualquiera puede leerla ahí. Llama a api14 desde tu servidor.
- Nunca subas claves al control de versiones. Usa variables de entorno o un gestor de secretos.
- Usa una clave por aplicación o entorno, para poder revocar una sin romper las demás.
- Fija un límite diario en USD en las claves que usen scripts o servicios menos fiables, para que un fallo no pueda vaciar tu saldo.
- Si una clave se filtra, revócala de inmediato en Claves de API.