Memulai
Autentikasi
Autentikasi ke api14 dengan API key sk-api14 yang dikirim sebagai Bearer token di header Authorization, plus tips keamanan dan rotasi key.
Setiap request ke endpoint berbayar diautentikasi dengan API key api14, yang dikirim sebagai Bearer token di header Authorization.
Authorization: Bearer sk-api14-...
SDK OpenAI mengatur header ini untuk Anda dari opsi apiKey / api_key.
API key
Buat dan kelola key di API keys.
- Key diawali dengan
sk-api14-dan hanya ditampilkan sekali, saat Anda membuatnya. Yang disimpan hanya hash-nya, jadi key yang hilang tidak bisa dipulihkan, buat key baru dan cabut key yang lama. - Setiap key bisa memiliki batas request per menit, batas pengeluaran harian dalam USD, dan allowlist model sendiri. Lihat Rate limit.
- Jumlah key yang bisa Anda miliki bergantung pada paket Anda: 1 di Free, 10 di Pro, lebih banyak di Team dan Enterprise.
- Pencabutan key langsung berlaku; request dengan key tersebut akan mengembalikan
401 invalid_api_key.
Menggunakan key
Simpan key di environment variable dan baca dari kode:
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 tanpa key
Endpoint katalog read-only berikut bisa dipakai tanpa autentikasi:
| Endpoint | Deskripsi |
|---|---|
GET /models | Semua model yang tersedia |
GET /models/{id} | Satu model |
GET /images/models | Model gambar beserta parameter tambahannya |
GET /videos/models | Model video beserta resolusi dan durasinya |
GET /embeddings/models | Model embedding |
Semua yang lain, endpoint generation, /credits, /key, /generation, dan status job video, memerlukan key.
Error autentikasi
Key yang tidak ada, salah format, atau sudah dicabut akan mengembalikan:
{
"error": {
"message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
"type": "authentication_error",
"code": "invalid_api_key"
}
}
dengan status HTTP 401. Key yang dibatasi oleh allowlist-nya akan mengembalikan 403 model_not_allowed untuk model lain. Lihat Error.
Menjaga key tetap aman
- Jangan pernah menaruh key di kode browser atau aplikasi mobile, siapa pun bisa membacanya di sana. Panggil api14 dari server Anda.
- Jangan pernah meng-commit key ke source control. Gunakan environment variable atau secret manager.
- Gunakan satu key per aplikasi atau environment, agar Anda bisa mencabut satu key tanpa mengganggu yang lain.
- Pasang batas USD harian pada key yang dipakai oleh skrip atau layanan yang kurang tepercaya, agar bug tidak bisa menguras saldo Anda.
- Jika sebuah key bocor, segera cabut di API keys.