Erste Schritte
Authentifizierung
Authentifizieren Sie sich bei api14 mit einem sk-api14-API-Schlüssel, der als Bearer-Token im Authorization-Header gesendet wird.
Jeder Request an einen kostenpflichtigen Endpunkt wird mit einem api14-API-Schlüssel authentifiziert, der als Bearer-Token im Authorization-Header gesendet wird.
Authorization: Bearer sk-api14-...
Die OpenAI-SDKs setzen diesen Header automatisch aus der Option apiKey / api_key.
API-Schlüssel
Erstellen und verwalten Sie Schlüssel unter API-Schlüssel.
- Schlüssel beginnen mit
sk-api14-und werden nur einmal angezeigt, nämlich beim Erstellen. Gespeichert wird nur ein Hash, daher lässt sich ein verlorener Schlüssel nicht wiederherstellen, erstellen Sie einen neuen und widerrufen Sie den alten. - Jeder Schlüssel kann ein eigenes Requests-pro-Minute-Limit, ein tägliches USD-Ausgabelimit und eine Modell-Allowlist haben. Siehe Rate Limits.
- Wie viele Schlüssel Sie haben können, hängt von Ihrem Plan ab: 1 im Free-Plan, 10 im Pro-Plan, mehr in Team und Enterprise.
- Das Widerrufen eines Schlüssels wirkt sofort; Requests damit liefern
401 invalid_api_key.
Einen Schlüssel verwenden
Bewahren Sie den Schlüssel in einer Umgebungsvariable auf und lesen Sie ihn im Code aus:
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);
Endpunkte ohne Schlüssel
Diese schreibgeschützten Katalog-Endpunkte funktionieren ohne Authentifizierung:
| Endpunkt | Beschreibung |
|---|---|
GET /models | Alle verfügbaren Modelle |
GET /models/{id} | Ein einzelnes Modell |
GET /images/models | Bildmodelle mit ihren zusätzlichen Parametern |
GET /videos/models | Videomodelle mit Auflösungen und Laufzeiten |
GET /embeddings/models | Embedding-Modelle |
Alles andere, Generierungs-Endpunkte, /credits, /key, /generation und der Status von Video-Jobs, erfordert einen Schlüssel.
Authentifizierungsfehler
Ein fehlender, fehlerhafter oder widerrufener Schlüssel liefert:
{
"error": {
"message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
"type": "authentication_error",
"code": "invalid_api_key"
}
}
mit HTTP-Status 401. Ein durch seine Allowlist eingeschränkter Schlüssel liefert für andere Modelle 403 model_not_allowed. Siehe Fehler.
Schlüssel sicher aufbewahren
- Legen Sie einen Schlüssel niemals in Browser- oder Mobile-App-Code ab, dort kann ihn jeder auslesen. Rufen Sie api14 von Ihrem Server aus auf.
- Committen Sie Schlüssel niemals in die Versionskontrolle. Verwenden Sie Umgebungsvariablen oder einen Secret Manager.
- Verwenden Sie einen Schlüssel pro App oder Umgebung, damit Sie einen widerrufen können, ohne die anderen zu beeinträchtigen.
- Setzen Sie ein tägliches USD-Limit für Schlüssel, die von Skripten oder weniger vertrauenswürdigen Diensten genutzt werden, damit ein Bug Ihr Guthaben nicht aufbrauchen kann.
- Wenn ein Schlüssel geleakt wurde, widerrufen Sie ihn sofort unter API-Schlüssel.