Endpunkte

Reasoning

Steuern Sie mit dem Parameter reasoning Denkaufwand, Budget und Ausgabe bei Reasoning-Modellen wie GPT-5, Claude, Gemini 2.5 und DeepSeek R1.

Im Playground testen

Reasoning-Modelle denken nach, bevor sie antworten: OpenAI GPT-5 und die o-Serie, Claude mit erweitertem Denken, Gemini 2.5, DeepSeek R1, Qwen und andere. api14 akzeptiert einen einzigen Parameter reasoning und übersetzt ihn in die jeweilige Einstellung des Anbieters. Reasoning-Token werden als Ausgabe-Token abgerechnet.

Anfrageparameter

Parameter	Typ	Beschreibung
`reasoning.effort`	string	`"minimal"`, `"low"`, `"medium"` oder `"high"`. Wird von OpenAI- und Grok-Modellen verwendet und bei anderen in ein Token-Budget umgerechnet.
`reasoning.max_tokens`	integer	Ein exaktes Denkbudget in Token. Wird von Anthropic, Gemini und Qwen verwendet. Verwenden Sie entweder dieses oder `effort`, nicht beides.
`reasoning.exclude`	boolean	Das Modell denkt trotzdem nach, der Denktext wird aber nicht in der Antwort zurückgegeben.
`reasoning.enabled`	boolean	Schaltet Reasoning mit den Standardeinstellungen ein.
`include_reasoning`	boolean	Veralteter Schalter, entspricht `reasoning: {}` oder `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 muss größer als das Denkbudget sein, weil es sowohl das Denken als auch die Antwort umfasst.

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

Antwort

Der Denktext wird in message.reasoning zurückgegeben, getrennt von der Antwort. Einige Modelle liefern außerdem strukturierte reasoning_details:

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

Beim Streaming kommt das Reasoning als delta.reasoning-Chunks, bevor die delta.content-Chunks folgen.

Hinweise

Modelle der OpenAI o-Serie und GPT-5 geben ihren Denktext nicht zurück, Sie zahlen aber trotzdem für die reasoning_tokens.
Senden Sie bei Tool-Nutzung über mehrere Runden mit Claude die reasoning_details unverändert in der Assistenten-Nachricht zurück, damit das Modell weiterdenken kann.
Einige Modelle (z. B. deepseek/deepseek-r1) denken immer. Bei ihnen wirkt effort nicht.
Höherer Aufwand kostet mehr und dauert länger. Behalten Sie completion_tokens_details.reasoning_tokens im Blick.

Fehler

Dasselbe wie bei Chat completions. Ein für ein Modell zu kleines oder zu großes Budget kann einen Upstream-Fehler 400 auslösen. Siehe Fehler.