Merge pull request #1720 from openai/release-please--branches--master--changes--next--components--openai

apcha-oai · web-flow · commit e5974fd54560 · 2025-12-11T13:18:14.000-05:00
release: 6.12.0
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "6.11.0"
+  ".": "6.12.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 136
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-88d85ff87ad8983262af2b729762a6e05fd509468bb691529bc2f81e4ce27c69.yml
-openapi_spec_hash: 46a55acbccd0147534017b92c1f4dd99
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-41f98da99f44ebe6204fce5c1dc9940f85f3472779e797b674c4fdc20306c77d.yml
+openapi_spec_hash: c61259027f421f501bdc6b23cf9e430e
 config_hash: 141b101c9f13b90e21af74e1686f1f41
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 6.12.0 (2025-12-11)
+
+Full Changelog: [v6.11.0...v6.12.0](https://github.com/openai/openai-node/compare/v6.11.0...v6.12.0)
+
+### Features
+
+* **api:** gpt 5.2 ([7000ddb](https://github.com/openai/openai-node/commit/7000ddb09ad4e272f43fe0d70cb1f6e5ca9ff725))
+
 ## 6.11.0 (2025-12-10)
 
 Full Changelog: [v6.10.0...v6.11.0](https://github.com/openai/openai-node/compare/v6.10.0...v6.11.0)
diff --git a/jsr.json b/jsr.json
@@ -1,6 +1,6 @@
 {
   "name": "@openai/openai",
-  "version": "6.11.0",
+  "version": "6.12.0",
   "exports": {
     ".": "./index.ts",
     "./helpers/zod": "./helpers/zod.ts",
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "openai",
-  "version": "6.11.0",
+  "version": "6.12.0",
   "description": "The official TypeScript library for the OpenAI API",
   "author": "OpenAI <support@openai.com>",
   "types": "dist/index.d.ts",
diff --git a/src/resources/beta/assistants.ts b/src/resources/beta/assistants.ts
@@ -1170,7 +1170,7 @@ export interface AssistantCreateParams {
    * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
    *   support `none`.
    * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-   * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+   * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
    */
   reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -1431,7 +1431,7 @@ export interface AssistantUpdateParams {
    * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
    *   support `none`.
    * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-   * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+   * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
    */
   reasoning_effort?: Shared.ReasoningEffort | null;
 
diff --git a/src/resources/beta/threads/runs/runs.ts b/src/resources/beta/threads/runs/runs.ts
@@ -735,7 +735,7 @@ export interface RunCreateParamsBase {
    * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
    *   support `none`.
    * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-   * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+   * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
    */
   reasoning_effort?: Shared.ReasoningEffort | null;
 
diff --git a/src/resources/chat/completions/completions.ts b/src/resources/chat/completions/completions.ts
@@ -1659,7 +1659,7 @@ export interface ChatCompletionCreateParamsBase {
    * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
    *   support `none`.
    * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-   * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+   * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
    */
   reasoning_effort?: Shared.ReasoningEffort | null;
 
diff --git a/src/resources/evals/runs/runs.ts b/src/resources/evals/runs/runs.ts
@@ -298,7 +298,7 @@ export namespace CreateEvalCompletionsRunDataSource {
      * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
      *   support `none`.
      * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-     * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
      */
     reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -607,7 +607,7 @@ export namespace RunCreateResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -759,7 +759,7 @@ export namespace RunCreateResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -1109,7 +1109,7 @@ export namespace RunRetrieveResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -1261,7 +1261,7 @@ export namespace RunRetrieveResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -1608,7 +1608,7 @@ export namespace RunListResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -1760,7 +1760,7 @@ export namespace RunListResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -2118,7 +2118,7 @@ export namespace RunCancelResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -2270,7 +2270,7 @@ export namespace RunCancelResponse {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -2567,7 +2567,7 @@ export namespace RunCreateParams {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
@@ -2719,7 +2719,7 @@ export namespace RunCreateParams {
        * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
        *   support `none`.
        * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-       * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+       * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
        */
       reasoning_effort?: Shared.ReasoningEffort | null;
 
diff --git a/src/resources/graders/grader-models.ts b/src/resources/graders/grader-models.ts
@@ -167,7 +167,8 @@ export interface PythonGrader {
  */
 export interface ScoreModelGrader {
   /**
-   * The input text. This may include template strings.
+   * The input messages evaluated by the grader. Supports text, output text, input
+   * image, and input audio content blocks, and may include template strings.
    */
   input: Array<ScoreModelGrader.Input>;
 
@@ -289,7 +290,7 @@ export namespace ScoreModelGrader {
      * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
      *   support `none`.
      * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-     * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
      */
     reasoning_effort?: Shared.ReasoningEffort | null;
 
diff --git a/src/resources/responses/responses.ts b/src/resources/responses/responses.ts
@@ -214,7 +214,7 @@ export class Responses extends APIResource {
    * @example
    * ```ts
    * const compactedResponse = await client.responses.compact({
-   *   model: 'gpt-5.1',
+   *   model: 'gpt-5.2',
    * });
    * ```
    */
@@ -6494,6 +6494,11 @@ export interface ResponseCompactParams {
    * available models.
    */
   model:
+    | 'gpt-5.2'
+    | 'gpt-5.2-2025-12-11'
+    | 'gpt-5.2-chat-latest'
+    | 'gpt-5.2-pro'
+    | 'gpt-5.2-pro-2025-12-11'
     | 'gpt-5.1'
     | 'gpt-5.1-2025-11-13'
     | 'gpt-5.1-codex'
diff --git a/src/resources/shared.ts b/src/resources/shared.ts
@@ -19,6 +19,11 @@ export type AllModels =
   | 'gpt-5.1-codex-max';
 
 export type ChatModel =
+  | 'gpt-5.2'
+  | 'gpt-5.2-2025-12-11'
+  | 'gpt-5.2-chat-latest'
+  | 'gpt-5.2-pro'
+  | 'gpt-5.2-pro-2025-12-11'
   | 'gpt-5.1'
   | 'gpt-5.1-2025-11-13'
   | 'gpt-5.1-codex'
@@ -257,7 +262,7 @@ export interface Reasoning {
    * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
    *   support `none`.
    * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-   * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+   * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
    */
   effort?: ReasoningEffort | null;
 
@@ -275,7 +280,8 @@ export interface Reasoning {
    * debugging and understanding the model's reasoning process. One of `auto`,
    * `concise`, or `detailed`.
    *
-   * `concise` is only supported for `computer-use-preview` models.
+   * `concise` is supported for `computer-use-preview` models and all reasoning
+   * models after `gpt-5`.
    */
   summary?: 'auto' | 'concise' | 'detailed' | null;
 }
@@ -293,7 +299,7 @@ export interface Reasoning {
  * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
  *   support `none`.
  * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
- * - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+ * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
  */
 export type ReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
 
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '6.11.0'; // x-release-please-version
+export const VERSION = '6.12.0'; // x-release-please-version
diff --git a/tests/api-resources/responses/responses.test.ts b/tests/api-resources/responses/responses.test.ts
@@ -75,7 +75,7 @@ describe('resource responses', () => {
   });
 
   test('compact: only required params', async () => {
-    const responsePromise = client.responses.compact({ model: 'gpt-5.1' });
+    const responsePromise = client.responses.compact({ model: 'gpt-5.2' });
     const rawResponse = await responsePromise.asResponse();
     expect(rawResponse).toBeInstanceOf(Response);
     const response = await responsePromise;
@@ -87,7 +87,7 @@ describe('resource responses', () => {
 
   test('compact: required and optional params', async () => {
     const response = await client.responses.compact({
-      model: 'gpt-5.1',
+      model: 'gpt-5.2',
       input: 'string',
       instructions: 'instructions',
       previous_response_id: 'resp_123',

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "6.11.0"`
	`2`	`+ ".": "6.12.0"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@openai/openai",`
`3`		`- "version": "6.11.0",`
	`3`	`+ "version": "6.12.0",`
`4`	`4`	`"exports": {`
`5`	`5`	`".": "./index.ts",`
`6`	`6`	`"./helpers/zod": "./helpers/zod.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "openai",`
`3`		`- "version": "6.11.0",`
	`3`	`+ "version": "6.12.0",`
`4`	`4`	`"description": "The official TypeScript library for the OpenAI API",`
`5`	`5`	`"author": "OpenAI <[email protected]>",`
`6`	`6`	`"types": "dist/index.d.ts",`