OpenAI: o4 Mini Deep Research – API Quickstart

Sample code and API for o4 Mini Deep Research

OpenRouter normalizes requests and responses across providers for you.

Get your API key

Create an API key from your OpenRouter dashboard and set it as an environment variable:

Make your first request

Use openai/o4-mini-deep-research with the OpenRouter API:

OpenRouter provides an OpenAI-compatible completion API to 400+ models & providers that you can call directly, or using the OpenAI SDK. Additionally, some third-party SDKs are available.

In the examples below, the OpenRouter-specific headers are optional. Setting them allows your app to appear on the OpenRouter leaderboards.

Using third-party SDKs

For information about using third-party SDKs and frameworks with OpenRouter, please see our frameworks documentation.

Enable streaming

Add "stream": true to your request body to receive responses as server-sent events:

Endpoint

POSThttps://openrouter.ai/api/v1/chat/completions

AuthorizationBearer $OPENROUTER_API_KEY

Content-Typeapplication/json

HTTP-Refereroptional — your site URL, for rankings

X-Titleoptional — your site name, for rankings

Modelopenai/o4-mini-deep-research

Parameters

Name	Type	Default	Description
`reasoning`	map	—	Controls reasoning behavior for models that support thinking tokens, including whether reasoning is enabled, the reasoning effort, maximum reasoning tokens, and whether reasoning is excluded from the response.
`include_reasoning`	boolean	—	Deprecated alias for reasoning.exclude.
`structured_outputs`	boolean	—	If the model can return structured outputs using response_format json_schema.
`response_format`	map	—	Forces the model to produce specific output format.
`seed`	integer	—	If specified, the inferencing will sample deterministically, such that repeated requests with the same seed and parameters should return the same result.
`max_tokens`	integer	—	This sets the upper limit for the number of tokens the model can generate in response.
`temperature`	float	`1`	This setting influences the variety in the model's responses.
`top_p`	float	`1`	This setting limits the model's choices to a percentage of likely tokens: only the top tokens whose probabilities add up to P.
`stop`	array	—	Stop generation immediately if the model encounter any token specified in the stop array.
`frequency_penalty`	float	`0`	This setting aims to control the repetition of tokens based on how often they appear in the input.
`presence_penalty`	float	`0`	Adjusts how often the model repeats specific tokens already used in the input.
`logit_bias`	map	—	Accepts a JSON object that maps tokens (specified by their token ID in the tokenizer) to an associated bias value from -100 to 100.
`logprobs`	boolean	—	Whether to return log probabilities of the output tokens or not.
`top_logprobs`	integer	—	An integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability.
`tools`	array	—	Tool calling parameter, following OpenAI's tool calling request shape.
`tool_choice`	string or object	—	Controls which (if any) tool is called by the model.