1847 1847
1848 - `"computer_use_preview"`1848 - `"computer_use_preview"`
1849 1849
1850 - `WebSearch object { type, filters, search_context_size, user_location }`1850 - `WebSearch object { type, external_web_access, filters, 2 more }`
1851 1851
1852 Search the Internet for sources related to the prompt. Learn more about the1852 Search the Internet for sources related to the prompt. Learn more about the
1853 [web search tool](/docs/guides/tools-web-search).1853 [web search tool](/docs/guides/tools-web-search).
1860 1860
1861 - `"web_search_2025_08_26"`1861 - `"web_search_2025_08_26"`
1862 1862
1863 - `external_web_access: optional boolean`
1864
1865 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
1866
1863 - `filters: optional object { allowed_domains } or null`1867 - `filters: optional object { allowed_domains } or null`
1864 1868
1865 Filters for the search.1869 Filters for the search.
3038 3042
3039 - `"computer_use_preview"`3043 - `"computer_use_preview"`
3040 3044
3041 - `WebSearch object { type, filters, search_context_size, user_location }`3045 - `WebSearch object { type, external_web_access, filters, 2 more }`
3042 3046
3043 Search the Internet for sources related to the prompt. Learn more about the3047 Search the Internet for sources related to the prompt. Learn more about the
3044 [web search tool](/docs/guides/tools-web-search).3048 [web search tool](/docs/guides/tools-web-search).
3051 3055
3052 - `"web_search_2025_08_26"`3056 - `"web_search_2025_08_26"`
3053 3057
3058 - `external_web_access: optional boolean`
3059
3060 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
3061
3054 - `filters: optional object { allowed_domains } or null`3062 - `filters: optional object { allowed_domains } or null`
3055 3063
3056 Filters for the search.3064 Filters for the search.
4907 Keys are strings with a maximum length of 64 characters. Values are strings4915 Keys are strings with a maximum length of 64 characters. Values are strings
4908 with a maximum length of 512 characters.4916 with a maximum length of 512 characters.
4909 4917
4910- `model: optional "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 96 more or string`4918- `model: optional "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more or string`
4911 4919
4912 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI4920 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI
4913 offers a wide range of models with different capabilities, performance4921 offers a wide range of models with different capabilities, performance
4914 characteristics, and price points. Refer to the [model guide](/docs/models)4922 characteristics, and price points. Refer to the [model guide](/docs/models)
4915 to browse and compare available models.4923 to browse and compare available models.
4916 4924
4917 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 96 more`4925 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more`
4918 4926
4919 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI4927 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI
4920 offers a wide range of models with different capabilities, performance4928 offers a wide range of models with different capabilities, performance
4929 4937
4930 - `"gpt-5.5"`4938 - `"gpt-5.5"`
4931 4939
4940 - `"gpt-5.5-2026-04-23"`
4941
4932 - `"gpt-5.4"`4942 - `"gpt-5.4"`
4933 4943
4934 - `"gpt-5.4-mini"`4944 - `"gpt-5.4-mini"`
5105 5115
5106 - `"computer-use-preview-2025-03-11"`5116 - `"computer-use-preview-2025-03-11"`
5107 5117
5118 - `"gpt-5.5-pro"`
5119
5120 - `"gpt-5.5-pro-2026-04-23"`
5121
5108 - `"gpt-5-codex"`5122 - `"gpt-5-codex"`
5109 5123
5110 - `"gpt-5-pro"`5124 - `"gpt-5-pro"`
5348 A stable identifier used to help detect users of your application that may be violating OpenAI's usage policies.5362 A stable identifier used to help detect users of your application that may be violating OpenAI's usage policies.
5349 The IDs should be a string that uniquely identifies each user, with a maximum length of 64 characters. We recommend hashing their username or email address, in order to avoid sending us any identifying information. [Learn more](/docs/guides/safety-best-practices#safety-identifiers).5363 The IDs should be a string that uniquely identifies each user, with a maximum length of 64 characters. We recommend hashing their username or email address, in order to avoid sending us any identifying information. [Learn more](/docs/guides/safety-best-practices#safety-identifiers).
5350 5364
5351- `service_tier: optional "auto" or "default" or "flex" or 3 more or null`5365- `service_tier: optional "auto" or "default" or "flex" or 4 more or null`
5352 5366
5353 Specifies the processing type used for serving the request.5367 Specifies the processing type used for serving the request.
5354 5368
5356 - If set to 'default', then the request will be processed with the standard pricing and performance for the selected model.5370 - If set to 'default', then the request will be processed with the standard pricing and performance for the selected model.
5357 - If set to '[flex](/docs/guides/flex-processing)', then the request will be processed with the Flex Processing service tier.5371 - If set to '[flex](/docs/guides/flex-processing)', then the request will be processed with the Flex Processing service tier.
5358 - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level, include the `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat Completions. The response will show `service_tier=priority` regardless of if you specify `service_tier=fast` or `priority` in your request.5372 - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level, include the `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat Completions. The response will show `service_tier=priority` regardless of if you specify `service_tier=fast` or `priority` in your request.
5373 - If set to 'ultrafast', then the request will be processed with the access-controlled Ultrafast Processing service tier. This tier is currently available for `gpt-5.6-sol`; a response served through it will show `service_tier=ultrafast`.
5359 - When not set, the default behavior is 'auto'.5374 - When not set, the default behavior is 'auto'.
5360 5375
5361 When the `service_tier` parameter is set, the response body will include the `service_tier` value based on the processing mode actually used to serve the request. This response value may be different from the value set in the parameter.5376 When the `service_tier` parameter is set, the response body will include the `service_tier` value based on the processing mode actually used to serve the request. This response value may be different from the value set in the parameter.
5372 5387
5373 - `"fast"`5388 - `"fast"`
5374 5389
5390 - `"ultrafast"`
5391
5375- `store: optional boolean or null`5392- `store: optional boolean or null`
5376 5393
5377 Whether to store the generated model response for later retrieval via5394 Whether to store the generated model response for later retrieval via
5945 5962
5946 - `"computer_use_preview"`5963 - `"computer_use_preview"`
5947 5964
5948 - `WebSearch object { type, filters, search_context_size, user_location }`5965 - `WebSearch object { type, external_web_access, filters, 2 more }`
5949 5966
5950 Search the Internet for sources related to the prompt. Learn more about the5967 Search the Internet for sources related to the prompt. Learn more about the
5951 [web search tool](/docs/guides/tools-web-search).5968 [web search tool](/docs/guides/tools-web-search).
5958 5975
5959 - `"web_search_2025_08_26"`5976 - `"web_search_2025_08_26"`
5960 5977
5978 - `external_web_access: optional boolean`
5979
5980 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
5981
5961 - `filters: optional object { allowed_domains } or null`5982 - `filters: optional object { allowed_domains } or null`
5962 5983
5963 Filters for the search.5984 Filters for the search.
8551 8572
8552 - `"computer_use_preview"`8573 - `"computer_use_preview"`
8553 8574
8554 - `WebSearch object { type, filters, search_context_size, user_location }`8575 - `WebSearch object { type, external_web_access, filters, 2 more }`
8555 8576
8556 Search the Internet for sources related to the prompt. Learn more about the8577 Search the Internet for sources related to the prompt. Learn more about the
8557 [web search tool](/docs/guides/tools-web-search).8578 [web search tool](/docs/guides/tools-web-search).
8564 8585
8565 - `"web_search_2025_08_26"`8586 - `"web_search_2025_08_26"`
8566 8587
8588 - `external_web_access: optional boolean`
8589
8590 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
8591
8567 - `filters: optional object { allowed_domains } or null`8592 - `filters: optional object { allowed_domains } or null`
8568 8593
8569 Filters for the search.8594 Filters for the search.
9742 9767
9743 - `"computer_use_preview"`9768 - `"computer_use_preview"`
9744 9769
9745 - `WebSearch object { type, filters, search_context_size, user_location }`9770 - `WebSearch object { type, external_web_access, filters, 2 more }`
9746 9771
9747 Search the Internet for sources related to the prompt. Learn more about the9772 Search the Internet for sources related to the prompt. Learn more about the
9748 [web search tool](/docs/guides/tools-web-search).9773 [web search tool](/docs/guides/tools-web-search).
9755 9780
9756 - `"web_search_2025_08_26"`9781 - `"web_search_2025_08_26"`
9757 9782
9783 - `external_web_access: optional boolean`
9784
9785 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
9786
9758 - `filters: optional object { allowed_domains } or null`9787 - `filters: optional object { allowed_domains } or null`
9759 9788
9760 Filters for the search.9789 Filters for the search.
11595 Keys are strings with a maximum length of 64 characters. Values are strings11624 Keys are strings with a maximum length of 64 characters. Values are strings
11596 with a maximum length of 512 characters.11625 with a maximum length of 512 characters.
11597 11626
11598 - `model: "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 96 more or string`11627 - `model: "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more or string`
11599 11628
11600 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI11629 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI
11601 offers a wide range of models with different capabilities, performance11630 offers a wide range of models with different capabilities, performance
11602 characteristics, and price points. Refer to the [model guide](/docs/models)11631 characteristics, and price points. Refer to the [model guide](/docs/models)
11603 to browse and compare available models.11632 to browse and compare available models.
11604 11633
11605 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 96 more`11634 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more`
11606 11635
11607 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI11636 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI
11608 offers a wide range of models with different capabilities, performance11637 offers a wide range of models with different capabilities, performance
11617 11646
11618 - `"gpt-5.5"`11647 - `"gpt-5.5"`
11619 11648
11649 - `"gpt-5.5-2026-04-23"`
11650
11620 - `"gpt-5.4"`11651 - `"gpt-5.4"`
11621 11652
11622 - `"gpt-5.4-mini"`11653 - `"gpt-5.4-mini"`
11793 11824
11794 - `"computer-use-preview-2025-03-11"`11825 - `"computer-use-preview-2025-03-11"`
11795 11826
11827 - `"gpt-5.5-pro"`
11828
11829 - `"gpt-5.5-pro-2026-04-23"`
11830
11796 - `"gpt-5-codex"`11831 - `"gpt-5-codex"`
11797 11832
11798 - `"gpt-5-pro"`11833 - `"gpt-5-pro"`
13025 13060
13026 - `"computer_use_preview"`13061 - `"computer_use_preview"`
13027 13062
13028 - `WebSearch object { type, filters, search_context_size, user_location }`13063 - `WebSearch object { type, external_web_access, filters, 2 more }`
13029 13064
13030 Search the Internet for sources related to the prompt. Learn more about the13065 Search the Internet for sources related to the prompt. Learn more about the
13031 [web search tool](/docs/guides/tools-web-search).13066 [web search tool](/docs/guides/tools-web-search).
13038 13073
13039 - `"web_search_2025_08_26"`13074 - `"web_search_2025_08_26"`
13040 13075
13076 - `external_web_access: optional boolean`
13077
13078 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
13079
13041 - `filters: optional object { allowed_domains } or null`13080 - `filters: optional object { allowed_domains } or null`
13042 13081
13043 Filters for the search.13082 Filters for the search.
14062 14101
14063 - `"computer_use_preview"`14102 - `"computer_use_preview"`
14064 14103
14065 - `WebSearch object { type, filters, search_context_size, user_location }`14104 - `WebSearch object { type, external_web_access, filters, 2 more }`
14066 14105
14067 Search the Internet for sources related to the prompt. Learn more about the14106 Search the Internet for sources related to the prompt. Learn more about the
14068 [web search tool](/docs/guides/tools-web-search).14107 [web search tool](/docs/guides/tools-web-search).
14075 14114
14076 - `"web_search_2025_08_26"`14115 - `"web_search_2025_08_26"`
14077 14116
14117 - `external_web_access: optional boolean`
14118
14119 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
14120
14078 - `filters: optional object { allowed_domains } or null`14121 - `filters: optional object { allowed_domains } or null`
14079 14122
14080 Filters for the search.14123 Filters for the search.
16218 16261
16219 - `"computer_use_preview"`16262 - `"computer_use_preview"`
16220 16263
16221 - `WebSearch object { type, filters, search_context_size, user_location }`16264 - `WebSearch object { type, external_web_access, filters, 2 more }`
16222 16265
16223 Search the Internet for sources related to the prompt. Learn more about the16266 Search the Internet for sources related to the prompt. Learn more about the
16224 [web search tool](/docs/guides/tools-web-search).16267 [web search tool](/docs/guides/tools-web-search).
16231 16274
16232 - `"web_search_2025_08_26"`16275 - `"web_search_2025_08_26"`
16233 16276
16277 - `external_web_access: optional boolean`
16278
16279 Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
16280
16234 - `filters: optional object { allowed_domains } or null`16281 - `filters: optional object { allowed_domains } or null`
16235 16282
16236 Filters for the search.16283 Filters for the search.
17284 A stable identifier used to help detect users of your application that may be violating OpenAI's usage policies.17331 A stable identifier used to help detect users of your application that may be violating OpenAI's usage policies.
17285 The IDs should be a string that uniquely identifies each user, with a maximum length of 64 characters. We recommend hashing their username or email address, in order to avoid sending us any identifying information. [Learn more](/docs/guides/safety-best-practices#safety-identifiers).17332 The IDs should be a string that uniquely identifies each user, with a maximum length of 64 characters. We recommend hashing their username or email address, in order to avoid sending us any identifying information. [Learn more](/docs/guides/safety-best-practices#safety-identifiers).
17286 17333
17287 - `service_tier: optional "auto" or "default" or "flex" or 3 more or null`17334 - `service_tier: optional "auto" or "default" or "flex" or 4 more or null`
17288 17335
17289 Specifies the processing type used for serving the request.17336 Specifies the processing type used for serving the request.
17290 17337
17292 - If set to 'default', then the request will be processed with the standard pricing and performance for the selected model.17339 - If set to 'default', then the request will be processed with the standard pricing and performance for the selected model.
17293 - If set to '[flex](/docs/guides/flex-processing)', then the request will be processed with the Flex Processing service tier.17340 - If set to '[flex](/docs/guides/flex-processing)', then the request will be processed with the Flex Processing service tier.
17294 - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level, include the `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat Completions. The response will show `service_tier=priority` regardless of if you specify `service_tier=fast` or `priority` in your request.17341 - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level, include the `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat Completions. The response will show `service_tier=priority` regardless of if you specify `service_tier=fast` or `priority` in your request.
17342 - If set to 'ultrafast', then the request will be processed with the access-controlled Ultrafast Processing service tier. This tier is currently available for `gpt-5.6-sol`; a response served through it will show `service_tier=ultrafast`.
17295 - When not set, the default behavior is 'auto'.17343 - When not set, the default behavior is 'auto'.
17296 17344
17297 When the `service_tier` parameter is set, the response body will include the `service_tier` value based on the processing mode actually used to serve the request. This response value may be different from the value set in the parameter.17345 When the `service_tier` parameter is set, the response body will include the `service_tier` value based on the processing mode actually used to serve the request. This response value may be different from the value set in the parameter.
17308 17356
17309 - `"fast"`17357 - `"fast"`
17310 17358
17359 - `"ultrafast"`
17360
17311 - `status: optional BetaResponseStatus`17361 - `status: optional BetaResponseStatus`
17312 17362
17313 The status of the response generation. One of `completed`, `failed`,17363 The status of the response generation. One of `completed`, `failed`,
