Uç noktalar
Chat completions
POST /chat/completions ile OpenAI sohbet formatında GPT, Claude, Gemini ve diğer metin modellerine istek gönderin; parametreler ve yanıt yapısı.
Playground’da deneChat completions uç noktası OpenAI sohbet formatını kullanır ve katalogdaki tüm metin modelleriyle çalışır: GPT, Claude, Gemini, Llama, DeepSeek, Mistral ve yüzlercesi daha. İstek gövdesi upstream sağlayıcıya değiştirilmeden gider. api14 yalnızca anahtarınızı, modeli, limitlerinizi ve bakiyenizi kontrol eder; ardından istek bittiğinde kullanımı kaydeder.
POST https://api14.com/api/v1/chat/completions
Authorization: Bearer sk-api14-...
Content-Type: application/json
İstek
| Parametre | Tür | Açıklama |
|---|---|---|
model | string, zorunlu | Model kimliği, örn. anthropic/claude-sonnet-4.5. :online veya :nitro gibi varyantlara izin verilir. Bkz. Model kimlikleri. |
messages | array, zorunlu | { role, content } nesnelerinden oluşan konuşma. Roller: system, developer, user, assistant, tool. |
models | string[] | İlki başarısız olursa sırayla denenecek yedek modeller. Bkz. Sağlayıcı yönlendirme. |
stream | boolean | Token'ları server-sent events olarak stream eder. Bkz. Streaming. |
max_tokens / max_completion_tokens | integer | Üretilecek token sayısı için üst sınır. |
temperature | number | Örnekleme sıcaklığı, genellikle 0–2. |
top_p, top_k, min_p, top_a | number | Diğer örnekleme ayarları. Desteklemeyen modeller bunları yok sayar. |
frequency_penalty, presence_penalty, repetition_penalty | number | Tekrar kontrolleri. |
stop | string | string[] | Durdurma dizileri. |
seed | integer | Mümkün olduğunca deterministik örnekleme. |
logprobs, top_logprobs | boolean, integer | Model destekliyorsa token log olasılıklarını döndürür. |
tools, tool_choice, parallel_tool_calls | Fonksiyon çağırma. Bkz. Araç çağırma. | |
response_format | object | JSON modu veya JSON Schema çıktısı. Bkz. Yapılandırılmış çıktılar. |
reasoning, include_reasoning | object, boolean | Düşünme ayarları. Bkz. Reasoning. |
plugins, web_search_options | Web araması. Bkz. Web araması. | |
provider | object | Upstream sağlayıcı tercihleri. Bkz. Sağlayıcı yönlendirme. |
modalities | string[] | örn. görsel çıktısı için ["image", "text"] veya ses çıktısı için ["text", "audio"]. |
prediction | object | Düzenlemelerde gecikmeyi azaltmak için tahmini çıktı ({ type: "content", content }). |
transforms | string[] | örn. bağlam penceresini aşan prompt'ları sıkıştırmak için ["middle-out"]. |
user | string | Kendi son kullanıcı tanımlayıcınız. |
Mesaj content alanı bir string veya içerik parçalarından (text, image_url, file, input_audio) oluşan bir dizi olabilir. Bkz. Görü ve dosyalar.
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);
Yanıt
{
"id": "gen-1760000000-abc123",
"object": "chat.completion",
"created": 1760000000,
"model": "anthropic/claude-sonnet-4.5",
"provider": "Anthropic",
"choices": [
{
"index": 0,
"finish_reason": "stop",
"message": { "role": "assistant", "content": "Hello! How can I help you today?" }
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 9,
"total_tokens": 21,
"prompt_tokens_details": { "cached_tokens": 0 },
"completion_tokens_details": { "reasoning_tokens": 0 },
"cost": 0.000171
}
}
usage.cost, isteğin USD cinsinden maliyetidir. api14 bu tutarı istek tamamlandıktan sonra bakiyenizden düşer. id, üretim kimliğidir; daha sonra Üretim sorgulama ile sorgulayabilirsiniz.
Faturalandırma notları
- Modelin listelenen fiyatını ödersiniz; ücret
usage.costiçinde döner. Bkz. Fiyatlandırma ve faturalandırma. - Başarısız istekler (herhangi bir 4xx veya 5xx durum kodu) için ücret alınmaz.
- İstek
models: [...]içeriyorsa, tüm yedek modellerin anahtarınız ve planınız için izinli olması gerekir; aksi halde ağ geçidi isteği upstream'e göndermeden reddeder.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 400 | model_required | model eksik. |
| 400 | invalid_json | Gövde bir JSON nesnesi değil. |
| 401 | invalid_api_key | Anahtar eksik, geçersiz veya iptal edilmiş. |
| 402 | insufficient_balance | USD bakiyeniz $0. |
| 403 | model_not_allowed / plan_required | Anahtarınızın izin listesi veya planınız bu modeli kapsamıyor. |
| 404 | model_not_found | Bilinmeyen veya devre dışı model kimliği. |
| 413 | payload_too_large | İstek gövdesi 25 MB'tan büyük. |
| 429 | rate_limited / daily_limit_reached | RPM limitine veya anahtarın günlük USD limitine ulaşıldı. |
| 502 | upstream_unavailable | Upstream sağlayıcıya ulaşılamadı. |
Bağlam uzunluğunun aşılması veya içerik moderasyonu gibi upstream hataları, orijinal durum kodları ve aynı hata yapısıyla döner. Bkz. Hatalar.