Endpoints

Reasoning

Beheer het budget, de inspanning en de uitvoer van redeneren bij redeneermodellen met de parameter reasoning, inclusief reasoning-tokens en kosten.

Probeer het in de playground

Redeneermodellen denken na voordat ze antwoorden: OpenAI GPT-5 en de o-reeks, Claude met uitgebreid denken, Gemini 2.5, DeepSeek R1, Qwen en andere. api14 accepteert één parameter reasoning en vertaalt die naar de eigen instelling van elke provider. Redeneertokens worden als uitvoertokens gefactureerd.

Requestparameters

Parameter	Type	Beschrijving
`reasoning.effort`	string	`"minimal"`, `"low"`, `"medium"` of `"high"`. Wordt gebruikt door OpenAI- en Grok-modellen en voor andere modellen omgezet naar een tokenbudget.
`reasoning.max_tokens`	integer	Een exact tokenbudget voor het denken. Wordt gebruikt door Anthropic, Gemini en Qwen. Gebruik dit of `effort`, niet allebei.
`reasoning.exclude`	boolean	Het model redeneert nog steeds, maar de redeneertekst wordt niet in het antwoord opgenomen.
`reasoning.enabled`	boolean	Schakelt redeneren in met de standaardinstellingen.
`include_reasoning`	boolean	Verouderde schakelaar, gelijk aan `reasoning: {}` of `reasoning.exclude: false`.

{
  "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 moet groter zijn dan het redeneerbudget, omdat het zowel het denken als het antwoord omvat.

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

Antwoord

De redeneertekst wordt teruggegeven in message.reasoning, los van het antwoord. Sommige modellen geven ook gestructureerde reasoning_details terug:

{
  "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
  }
}

Bij streamen komt de redenering in delta.reasoning-chunks, vóór de delta.content-chunks.

Opmerkingen

Modellen uit de OpenAI o-reeks en GPT-5 geven hun redeneertekst niet terug, maar je betaalt wel voor de reasoning_tokens.
Stuur bij toolgebruik met Claude over meerdere beurten reasoning_details ongewijzigd terug in het assistentbericht, zodat het model verder kan redeneren.
Sommige modellen (bijvoorbeeld deepseek/deepseek-r1) redeneren altijd. Voor die modellen heeft effort geen effect.
Een hogere inspanning kost meer en duurt langer. Houd completion_tokens_details.reasoning_tokens in de gaten.

Fouten

Hetzelfde als bij Chat completions. Een budget dat te klein of te groot is voor een model kan een upstream-400 geven. Zie Fouten.