Pierwsze kroki
Uwierzytelnianie
Uwierzytelniaj zapytania do api14 kluczem API sk-api14 przesyłanym w nagłówku Authorization jako token Bearer i chroń swoje klucze.
Każde żądanie do płatnego endpointu jest uwierzytelniane kluczem API api14, przesyłanym jako token Bearer w nagłówku Authorization.
Authorization: Bearer sk-api14-...
SDK OpenAI ustawiają ten nagłówek za ciebie na podstawie opcji apiKey / api_key.
Klucze API
Twórz klucze i zarządzaj nimi w sekcji Klucze API.
- Klucze zaczynają się od
sk-api14-i są wyświetlane tylko raz, podczas tworzenia. Przechowujemy wyłącznie hash, więc zgubionego klucza nie da się odzyskać, utwórz nowy i unieważnij stary. - Każdy klucz może mieć własny limit żądań na minutę, dzienny limit wydatków w USD i listę dozwolonych modeli. Zobacz Limity zapytań.
- Liczba kluczy, które możesz mieć, zależy od planu: 1 w Free, 10 w Pro, więcej w Team i Enterprise.
- Unieważnienie klucza działa natychmiast; żądania z tym kluczem zwracają
401 invalid_api_key.
Używanie klucza
Trzymaj klucz w zmiennej środowiskowej i odczytuj go w kodzie:
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);
Endpointy bez klucza
Te endpointy katalogu, przeznaczone tylko do odczytu, działają bez uwierzytelniania:
| Endpoint | Opis |
|---|---|
GET /models | Wszystkie dostępne modele |
GET /models/{id} | Jeden model |
GET /images/models | Modele graficzne z dodatkowymi parametrami |
GET /videos/models | Modele wideo z rozdzielczościami i długościami |
GET /embeddings/models | Modele embeddingów |
Wszystko inne, endpointy generowania, /credits, /key, /generation i status zadań wideo, wymaga klucza.
Błędy uwierzytelniania
Brakujący, nieprawidłowy lub unieważniony klucz zwraca:
{
"error": {
"message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
"type": "authentication_error",
"code": "invalid_api_key"
}
}
ze statusem HTTP 401. Klucz ograniczony listą dozwolonych modeli zwraca 403 model_not_allowed dla pozostałych modeli. Zobacz Błędy.
Bezpieczeństwo kluczy
- Nigdy nie umieszczaj klucza w kodzie przeglądarki ani aplikacji mobilnej, każdy może go tam odczytać. Wywołuj api14 ze swojego serwera.
- Nigdy nie commituj kluczy do systemu kontroli wersji. Używaj zmiennych środowiskowych lub menedżera sekretów.
- Używaj osobnego klucza dla każdej aplikacji lub środowiska, aby móc unieważnić jeden bez psucia pozostałych.
- Ustaw dzienny limit w USD dla kluczy używanych przez skrypty lub mniej zaufane usługi, żeby błąd w kodzie nie wyczyścił ci salda.
- Jeśli klucz wycieknie, natychmiast unieważnij go w sekcji Klucze API.