Run options

Run options allow callers to tweak how a model executes. Options are model-specific.

Option keys

Key	Applies to	Values (by model)
reasoningEffort	text	see below
quality	image	see below

Values by model

Model	reasoningEffort	quality
gpt-5	minimal, low, medium, high	–
gpt-5-nano	minimal, low, medium, high	–
gpt-5-mini	minimal, low, medium, high	–
o4-mini	low, medium, high	–
o3-mini	low, medium, high	–
o3	low, medium, high	–
dall-e-3	–	standard, hd
gpt-image-1	–	low, medium, high

Notes:

• Send run options via the runOptions object in POST /v1/runs.
• Keys must be valid for the selected model; unrecognized keys are ignored.

Used by:

• Runs: Create a run