Başlarken
OpenAI SDK uyumluluğu
Resmi OpenAI SDK'larını değiştirmeden kullanın; yalnızca base URL ve API anahtarını değiştirerek OpenAI'dan veya uyumlu bir API'den api14'e geçin.
api14, OpenAI API'sini konuşur. Resmi OpenAI SDK'larının tümü ve özel bir OpenAI base URL'i kabul eden her araç kod değişikliği olmadan çalışır, yalnızca base URL'i ve API anahtarını değiştirirsiniz.
Değiştirilecek iki değer
| Ayar | Değer |
|---|---|
| Base URL | https://api14.com/api/v1 |
| API anahtarı | sk-api14-... anahtarınız |
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://api14.com/api/v1',
apiKey: process.env.API14_API_KEY,
})
import os
from openai import OpenAI
client = OpenAI(base_url="https://api14.com/api/v1", api_key=os.environ["API14_API_KEY"])
Birçok SDK OPENAI_BASE_URL ve OPENAI_API_KEY ortam değişkenlerini de okur; böylece koda hiç dokunmadan geçiş yapabilirsiniz.
Neler uyumlu
| OpenAI özelliği | api14 |
|---|---|
stream, tools, response_format dahil chat.completions.create | Tüm metin modelleri için desteklenir |
responses.create | Desteklenir |
completions.create | Desteklenir |
embeddings.create | Desteklenir |
images.generate | Desteklenir (/images/generations) |
audio.speech.create | Desteklenir |
audio.transcriptions.create | Desteklenir (multipart) |
models.list / models.retrieve | Fiyatlar ve kategorilerle birlikte desteklenir |
Hata yapısı { error: { message, type, code } } | Aynı, SDK'lar her zamanki APIError hatasını fırlatır |
Yalnızca OpenAI'da bulunan uç noktalar (Assistants, Threads, fine-tuning, files, batches, vector stores ve moderations) kullanılamaz.
OpenAI'dan geçiş
- Base URL'i
https://api14.com/api/v1olarak ayarlayın ve api14 anahtarınızı kullanın. - Model adlarının başına sağlayıcıyı ekleyin:
gpt-5-mini,openai/gpt-5-miniolur;text-embedding-3-small,openai/text-embedding-3-smallolur. - Hepsi bu. Artık model kimliğini değiştirerek başka herhangi bir sağlayıcıya da geçebilirsiniz; örneğin
anthropic/claude-sonnet-4.5veyagoogle/gemini-2.5-pro.
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);
OpenAI uyumlu başka bir API'den geçiş
- Base URL'i
https://api14.com/api/v1olarak ayarlayın. - Mevcut API anahtarınızı api14 anahtarınızla değiştirin.
- Model kimlikleri
sağlayıcı/modelbiçimindedir (örneğinopenai/gpt-5-mini). Ayrıca şunlar desteklenir: varyantlar (:free,:online,:nitro,:floor),provideryönlendirmesi,modelsyedekleri,reasoning,plugins,transformsveusage.
Bilmeniz gereken farklar:
- Faturalandırma bir USD bakiyesi üzerindendir.
GET /credits, USD cinsindentotal_creditsvetotal_usagealanlarının yanı sırabalance_usddöndürür. Bkz. Bakiye ve anahtar bilgisi. - Kullanım maliyeti her zaman dahildir. Ağ geçidi upstream'den her zaman
usage.costister; böylece her yanıt kendi fiyatını bildirir. HTTP-RefererveX-Titlegibi başlıklar ağ geçidi tarafından ayarlanır; bunları göndermeniz gerekmez.- Video işi URL'leri her zaman api14'e (
/api/v1/videos/{id}) işaret eder, asla upstream'e değil. Bkz. Video.
SDK'larda ek parametreler
OpenAI SDK'sının tanımadığı alanlar yine de gönderilebilir:
await client.chat.completions.create({
model: 'openai/gpt-5-mini',
messages: [{ role: 'user', content: 'Hi' }],
// @ts-expect-error api14 extension
provider: { sort: 'price' },
})
client.chat.completions.create(
model="openai/gpt-5-mini",
messages=[{"role": "user", "content": "Hi"}],
extra_body={"provider": {"sort": "price"}},
)
Bkz. Sağlayıcı yönlendirme ve yedekler, Reasoning ve Web araması.