# ModelSettings

OpenAI settings the AI step passes to the model. Honoured only with the
user's own OpenAI key (core-lib ai_processor/processors.py).

Type: object

Fields typed as another model are documented on that model's page; fetch it before filling the field.

| Field | Type | Required | Description | Allowed values / default / constraints |
| --- | --- | --- | --- | --- |
| `temperature` | number, nullable | no |  | min: 0.0; max: 2.0 |
| `top_p` | number, nullable | no |  | min: 0.0; max: 1.0 |
| `frequency_penalty` | number, nullable | no |  | min: -2.0; max: 2.0 |
| `presence_penalty` | number, nullable | no |  | min: -2.0; max: 2.0 |
| `max_completion_tokens` | integer, nullable | no |  | exclusive min: 1.0 |
| `reasoning_effort` | string, nullable | no | Applied by the engine only to models whose id starts with `o`. | one of: `"low"`, `"medium"`, `"high"` |

## Used by

- [GET /rest/beta/automations/](https://dev-api.sheetgo.com/rest/reference/automations.md#get-rest-beta-automations)
- [GET /rest/beta/automations/{id}](https://dev-api.sheetgo.com/rest/reference/automations.md#get-rest-beta-automations-id)
- [PATCH /rest/beta/automations/{id}](https://dev-api.sheetgo.com/rest/reference/automations.md#patch-rest-beta-automations-id)
- [POST /rest/beta/automations/](https://dev-api.sheetgo.com/rest/reference/automations.md#post-rest-beta-automations)
- [PUT /rest/beta/automations/{id}](https://dev-api.sheetgo.com/rest/reference/automations.md#put-rest-beta-automations-id)
- [AIProcessor](https://dev-api.sheetgo.com/rest/reference/models/AIProcessor.md)

---

More: start page https://dev-api.sheetgo.com/rest/reference.md, everything in one file https://dev-api.sheetgo.com/rest/llms-full.txt, OpenAPI https://dev-api.sheetgo.com/rest/openapi.json.