Per iniziare

Autenticazione

Come autenticarsi con una chiave API sk-api14 inviata come token Bearer, dove crearla, come tenerla al sicuro e come ruotarla.

Ogni richiesta a un endpoint a consumo viene autenticata con una chiave API di api14, inviata come token Bearer nell'header Authorization.

Authorization: Bearer sk-api14-...

Gli SDK di OpenAI impostano questo header per te a partire dall'opzione apiKey / api_key.

Chiavi API

Crea e gestisci le chiavi in Chiavi API.

Le chiavi iniziano con sk-api14- e vengono mostrate una sola volta, al momento della creazione. Viene salvato solo un hash, quindi una chiave persa non può essere recuperata, creane una nuova e revoca quella vecchia.
Ogni chiave può avere un proprio limite di richieste al minuto, un limite di spesa giornaliero in USD e una lista di modelli consentiti. Vedi Limiti di frequenza.
Il numero di chiavi che puoi avere dipende dal tuo piano: 1 su Free, 10 su Pro, di più su Team ed Enterprise.
La revoca di una chiave ha effetto immediato; le richieste che la usano restituiscono 401 invalid_api_key.

Usare una chiave

Conserva la chiave in una variabile d'ambiente e leggila nel codice:

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);

Endpoint senza chiave

Questi endpoint di catalogo in sola lettura funzionano senza autenticazione:

Endpoint	Descrizione
`GET /models`	Tutti i modelli disponibili
`GET /models/{id}`	Un singolo modello
`GET /images/models`	Modelli di immagini con i relativi parametri aggiuntivi
`GET /videos/models`	Modelli video con risoluzioni e durate
`GET /embeddings/models`	Modelli di embeddings

Tutto il resto, endpoint di generazione, /credits, /key, /generation e stato dei job video, richiede una chiave.

Errori di autenticazione

Una chiave mancante, malformata o revocata restituisce:

{
  "error": {
    "message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

con stato HTTP 401. Una chiave limitata dalla sua lista di modelli consentiti restituisce 403 model_not_allowed per gli altri modelli. Vedi Errori.

Tenere al sicuro le chiavi

Non inserire mai una chiave nel codice di un browser o di un'app mobile, chiunque potrebbe leggerla. Chiama api14 dal tuo server.
Non fare mai commit delle chiavi nel controllo di versione. Usa variabili d'ambiente o un secret manager.
Usa una chiave per ogni app o ambiente, così puoi revocarne una senza compromettere le altre.
Imposta un limite giornaliero in USD sulle chiavi usate da script o servizi meno affidabili, così un bug non può prosciugare il tuo saldo.
Se una chiave viene esposta, revocala subito in Chiavi API.