Uç noktalar

Reasoning

reasoning parametresiyle düşünen modellerin düşünme bütçesini, çabasını ve düşünce çıktısını yönetin; GPT-5, Claude, Gemini ve DeepSeek R1 için tek arayüz.

Playground’da dene

Düşünen (reasoning) modeller yanıt vermeden önce düşünür: OpenAI GPT-5 ve o serisi, genişletilmiş düşünmeli Claude, Gemini 2.5, DeepSeek R1, Qwen ve diğerleri. api14 tek bir reasoning parametresi kabul eder ve bunu her sağlayıcının kendi ayarına çevirir. Reasoning token'ları çıktı token'ı olarak faturalanır.

İstek parametreleri

Parametre	Tür	Açıklama
`reasoning.effort`	string	`"minimal"`, `"low"`, `"medium"` veya `"high"`. OpenAI ve Grok modellerinde kullanılır, diğerlerinde bir token bütçesine çevrilir.
`reasoning.max_tokens`	integer	Düşünme için kesin bir token bütçesi. Anthropic, Gemini ve Qwen'de kullanılır. Bunlardan yalnızca birini kullanın, ikisini birden değil.
`reasoning.exclude`	boolean	Model yine düşünür, ancak düşünce metni yanıtta yer almaz.
`reasoning.enabled`	boolean	Reasoning'i varsayılan ayarlarla açar.
`include_reasoning`	boolean	Eski anahtar. `reasoning: {}` ya da `reasoning.exclude: false` ile aynıdır.

{
  "model": "anthropic/claude-sonnet-4.5",
  "messages": [{ "role": "user", "content": "How many r's are in 'strawberry'? Think carefully." }],
  "reasoning": { "max_tokens": 2000 },
  "max_tokens": 4000
}

max_tokens, düşünme ve yanıtın toplamını kapsadığı için reasoning bütçesinden büyük olmalıdır.

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."
    }
  ],
  "reasoning": {
    "effort": "high"
  }
});
console.log(result.choices[0].message.content);

Yanıt

Düşünce metni message.reasoning içinde, yanıttan ayrı olarak döner. Bazı modeller ayrıca yapılandırılmış reasoning_details döndürür:

{
  "id": "gen-1760000000-think",
  "model": "anthropic/claude-sonnet-4.5",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "There are 3 r's in \"strawberry\".",
        "reasoning": "s-t-r-a-w-b-e-r-r-y: r at position 3, 8 and 9..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 22,
    "completion_tokens": 312,
    "total_tokens": 334,
    "completion_tokens_details": { "reasoning_tokens": 290 },
    "cost": 0.004746
  }
}

Akış (stream) sırasında reasoning, delta.content parçalarından önce delta.reasoning parçaları olarak gelir.

Notlar

OpenAI o serisi ve GPT-5 modelleri düşünce metnini döndürmez, ancak reasoning_tokens için yine ücret alırsınız.
Claude ile çok turlu araç kullanımında reasoning_details değerini asistan mesajında değiştirmeden geri gönderin, böylece model düşünmeye devam edebilir.
Bazı modeller (ör. deepseek/deepseek-r1) her zaman düşünür. Bunlarda effort uygulanmaz.
Yüksek effort daha pahalıya ve daha yavaşa gelir. completion_tokens_details.reasoning_tokens değerini takip edin.

Hatalar

Chat completions ile aynıdır. Bir model için çok küçük ya da çok büyük bir bütçe, upstream'den 400 dönebilir. Bkz. Hatalar.