Run options

Run options allow callers to tweak how a model executes. Options are model-specific — not every model supports every option.

Option keys

Key	Applies to	Description
reasoningEffort	Some text models	Controls reasoning depth. Values vary by model.
quality	Some image models	Controls output quality. Values vary by model.

Finding available options per model

The GET /v1/resources endpoint returns an availableRunOptions array for each model, listing which option keys are supported and what values they accept. This is the authoritative source.

Example entry from the resources response:

{
  "model": "o3",
  "modality": "text",
  "availableRunOptions": [
    {
      "key": "reasoningEffort",
      "options": ["low", "medium", "high"]
    }
  ]
}

Usage

Send run options via the runOptions object in POST /v1/runs:

{
  "promptVersionId": "...",
  "inputs": { "textInputs": { "topic": "quantum computing" } },
  "runOptions": {
    "reasoningEffort": "high"
  }
}

Keys must be valid for the selected model; unrecognized keys cause a validation error.

See also

• Models & Options guide: Models & Options
• Fetch available options: GET /v1/resources
• Create a run: POST /v1/runs