id | string | Yes | — | Model identifier (e.g., gpt-4o) |
api_key | Field[string] | Yes | — | OpenAI API key. Use a FieldReference to inject from a secret |
max_tokens | integer | No | — | Maximum tokens in responses |
temperature | float | No | — | Sampling temperature (0.0–2.0) |
top_p | float | No | — | Nucleus sampling parameter |
frequency_penalty | float | No | — | Frequency penalty (−2.0 to 2.0) |
presence_penalty | float | No | — | Presence penalty (−2.0 to 2.0) |
seed | integer | No | — | Random seed for deterministic outputs |
stop | string or list[string] | No | — | Stop sequences |
timeout | float | No | — | Request timeout in seconds |
max_retries | integer | No | — | Maximum retry attempts |
organization | string | No | — | OpenAI organization ID |
base_url | string | No | — | Custom base URL (for OpenAI-compatible APIs) |