feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 111
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-c7dacca97e28bceff218684bb429481a70aa47aadad983ed9178bfda75ff4cd2.yml
-openapi_spec_hash: 28eb1bb901ca10d2e37db4606d2bcfa7
-config_hash: 167ad0ca036d0f023c78e6496b4311e8
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-670ea0d2cc44f52a87dd3cadea45632953283e0636ba30788fdbdb22a232ccac.yml
+openapi_spec_hash: d8b7d38911fead545adf3e4297956410
+config_hash: 5525bda35e48ea6387c6175c4d1651fa

api.md

@@ -119,6 +119,12 @@ Methods:
 Types:
 
 - <code><a href="./src/resources/images.ts">Image</a></code>
+- <code><a href="./src/resources/images.ts">ImageEditCompletedEvent</a></code>
+- <code><a href="./src/resources/images.ts">ImageEditPartialImageEvent</a></code>
+- <code><a href="./src/resources/images.ts">ImageEditStreamEvent</a></code>
+- <code><a href="./src/resources/images.ts">ImageGenCompletedEvent</a></code>
+- <code><a href="./src/resources/images.ts">ImageGenPartialImageEvent</a></code>
+- <code><a href="./src/resources/images.ts">ImageGenStreamEvent</a></code>
 - <code><a href="./src/resources/images.ts">ImageModel</a></code>
 - <code><a href="./src/resources/images.ts">ImagesResponse</a></code>
 

examples/image-stream.ts

@@ -0,0 +1,51 @@
+#!/usr/bin/env -S npm run tsn -T
+
+import OpenAI from 'openai';
+import fs from 'fs';
+import path from 'path';
+
+const client = new OpenAI();
+
+const main = async () => {
+  const stream = await client.images.generate({
+    model: 'gpt-image-1',
+    prompt: 'A cute baby sea otter',
+    n: 1,
+    size: '1024x1024',
+    stream: true,
+    partial_images: 3,
+  });
+
+  for await (const event of stream) {
+    let filename: string;
+    let imageBuffer: Buffer;
+    switch (event.type) {
+      case 'image_generation.partial_image':
+        console.log(`  Partial image ${event.partial_image_index + 1}/3 received`);
+        console.log(`   Size: ${event.b64_json.length} characters (base64)`);
+
+        // Save partial image to file
+        filename = `partial_${event.partial_image_index + 1}.png`;
+        imageBuffer = Buffer.from(event.b64_json, 'base64');
+        fs.writeFileSync(filename, imageBuffer);
+        console.log(`   💾 Saved to: ${path.resolve(filename)}`);
+        break;
+      case 'image_generation.completed':
+        console.log(`\n✅ Final image completed!`);
+        console.log(`   Size: ${event.b64_json.length} characters (base64)`);
+
+        // Save final image to file
+        filename = 'final_image.png';
+        imageBuffer = Buffer.from(event.b64_json, 'base64');
+        fs.writeFileSync(filename, imageBuffer);
+        console.log(`    Saved to: ${path.resolve(filename)}`);
+        break;
+      default:
+        console.log(`❓ Unknown event: ${event}`);
+    }
+  }
+};
+
+main().catch((error) => {
+  console.error('Error generating image:', error);
+});

src/client.ts

@@ -57,8 +57,18 @@ import {
 import {
   Image,
   ImageCreateVariationParams,
+  ImageEditCompletedEvent,
   ImageEditParams,
+  ImageEditParamsNonStreaming,
+  ImageEditParamsStreaming,
+  ImageEditPartialImageEvent,
+  ImageEditStreamEvent,
+  ImageGenCompletedEvent,
+  ImageGenPartialImageEvent,
+  ImageGenStreamEvent,
   ImageGenerateParams,
+  ImageGenerateParamsNonStreaming,
+  ImageGenerateParamsStreaming,
   ImageModel,
   Images,
   ImagesResponse,
@@ -1039,11 +1049,21 @@ export declare namespace OpenAI {
   export {
     Images as Images,
     type Image as Image,
+    type ImageEditCompletedEvent as ImageEditCompletedEvent,
+    type ImageEditPartialImageEvent as ImageEditPartialImageEvent,
+    type ImageEditStreamEvent as ImageEditStreamEvent,
+    type ImageGenCompletedEvent as ImageGenCompletedEvent,
+    type ImageGenPartialImageEvent as ImageGenPartialImageEvent,
+    type ImageGenStreamEvent as ImageGenStreamEvent,
     type ImageModel as ImageModel,
     type ImagesResponse as ImagesResponse,
     type ImageCreateVariationParams as ImageCreateVariationParams,
     type ImageEditParams as ImageEditParams,
+    type ImageEditParamsNonStreaming as ImageEditParamsNonStreaming,
+    type ImageEditParamsStreaming as ImageEditParamsStreaming,
     type ImageGenerateParams as ImageGenerateParams,
+    type ImageGenerateParamsNonStreaming as ImageGenerateParamsNonStreaming,
+    type ImageGenerateParamsStreaming as ImageGenerateParamsStreaming,
   };
 
   export { Audio as Audio, type AudioModel as AudioModel, type AudioResponseFormat as AudioResponseFormat };

src/core/streaming.ts

@@ -57,6 +57,8 @@ export class Stream<Item> implements AsyncIterable<Item> {
           if (
             sse.event === null ||
             sse.event.startsWith('response.') ||
+            sse.event.startsWith('image_edit.') ||
+            sse.event.startsWith('image_generation.') ||
             sse.event.startsWith('transcript.')
           ) {
             let data;