Başlarken

Kimlik doğrulama

api14 API anahtarını Authorization başlığında Bearer token olarak göndererek isteklerinizi nasıl doğrulayacağınızı ve anahtarı güvenle kullanacağınızı öğrenin.

Ücretlendirilen bir uç noktaya yapılan her istek, Authorization başlığında Bearer token olarak gönderilen bir api14 API anahtarıyla doğrulanır.

Authorization: Bearer sk-api14-...

OpenAI SDK'ları bu başlığı apiKey / api_key seçeneğinden sizin için otomatik olarak ayarlar.

API anahtarları

Anahtarlarınızı API anahtarları sayfasından oluşturun ve yönetin.

Anahtarlar sk-api14- ile başlar ve oluşturulduklarında yalnızca bir kez gösterilir. Yalnızca bir hash saklandığından kaybolan bir anahtar kurtarılamaz, yeni bir anahtar oluşturun ve eskisini iptal edin.
Her anahtarın kendine ait bir dakikalık istek limiti, günlük USD harcama limiti ve model izin listesi olabilir. Bkz. Hız limitleri.
Sahip olabileceğiniz anahtar sayısı planınıza bağlıdır: Free'de 1, Pro'da 10, Team ve Enterprise'da daha fazla.
Bir anahtarı iptal etmek anında geçerli olur; o anahtarla yapılan istekler 401 invalid_api_key döndürür.

Anahtar kullanımı

Anahtarı bir ortam değişkeninde tutun ve kodda oradan okuyun:

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

Anahtar gerektirmeyen uç noktalar

Aşağıdaki salt okunur katalog uç noktaları kimlik doğrulama olmadan çalışır:

Uç nokta	Açıklama
`GET /models`	Tüm kullanılabilir modeller
`GET /models/{id}`	Tek bir model
`GET /images/models`	Ek parametreleriyle birlikte görsel modelleri
`GET /videos/models`	Çözünürlük ve süreleriyle birlikte video modelleri
`GET /embeddings/models`	Embedding modelleri

Geri kalan her şey, üretim uç noktaları, /credits, /key, /generation ve video işi durumu, bir anahtar gerektirir.

Kimlik doğrulama hataları

Eksik, hatalı biçimlendirilmiş veya iptal edilmiş bir anahtar şunu döndürür:

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

HTTP durum kodu 401 ile birlikte. İzin listesiyle kısıtlanmış bir anahtar, diğer modeller için 403 model_not_allowed döndürür. Bkz. Hatalar.

Anahtarları güvende tutmak

Bir anahtarı asla tarayıcı veya mobil uygulama koduna koymayın, orada herkes okuyabilir. api14'ü sunucunuzdan çağırın.
Anahtarları asla kaynak kontrolüne commit etmeyin. Ortam değişkenleri veya bir secret yöneticisi kullanın.
Her uygulama veya ortam için ayrı bir anahtar kullanın; böylece diğerlerini bozmadan birini iptal edebilirsiniz.
Script'lerin veya daha az güvenilen servislerin kullandığı anahtarlara günlük USD limiti koyun; böylece bir hata bakiyenizi tüketemez.
Bir anahtar sızarsa hemen API anahtarları sayfasından iptal edin.