Models

OpenAI

GitHub Edit page

OpenAI models

Use OpenAI directly by choosing an openai/... model id.

For the full model/provider matrix, see docs/llm.md.

Fast mode is a service tier, not a model id. Prefer flags:

summarize URL --model openai/gpt-5.5 --fast --thinking medium
summarize URL --model openai/gpt-5.4 --service-tier fast --thinking low

Compatibility aliases:

  • --model gpt-fast / --model fast: openai/gpt-5.5 with fast service tier and medium thinking.
  • --model openai/gpt-5.5-fast or --model openai/gpt-5.4-mini-fast: strip the -fast suffix for the API model id and use fast service tier.
  • --model codex-fast: explicit Codex CLI fast preset.

#Env

  • OPENAI_API_KEY (required for openai/... models)
  • OPENAI_USE_CHAT_COMPLETIONS (optional; force chat completions)

#Flags

  • --model openai/<model>
  • --fast
  • --service-tier default|fast|priority|flex
  • --thinking none|low|medium|high|xhigh
  • --length short|medium|long|xl|xxl|<chars>
  • This is soft guidance to the model (no hard truncation).
  • --max-output-tokens <count>
  • Hard cap for output tokens (optional).
  • --json (includes prompt + summary in one JSON object)

#Config

{
  "openai": {
    "serviceTier": "fast",
    "thinking": "medium"
  }
}

openai.reasoningEffort is the long-form alias for openai.thinking. Model presets can also set serviceTier, thinking / reasoningEffort, and textVerbosity.

Use "serviceTier": "fast" in summarize config and model presets. OpenAI API requests map that to service_tier="priority"; "flex" and explicit "priority" pass through as-is. Use --service-tier default to clear a configured tier for one run.

#PDF inputs

  • When a PDF is provided and --preprocess auto is used, summarize sends the PDF as a file input via the OpenAI Responses API.
  • Document streaming is disabled for file inputs; non-streaming calls are used instead.