feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 97
-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

@@ -136,6 +136,12 @@ Params Types:
 Response Types:
 
 - <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#Image">Image</a>
+- <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#ImageEditCompletedEvent">ImageEditCompletedEvent</a>
+- <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#ImageEditPartialImageEvent">ImageEditPartialImageEvent</a>
+- <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#ImageEditStreamEventUnion">ImageEditStreamEventUnion</a>
+- <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#ImageGenCompletedEvent">ImageGenCompletedEvent</a>
+- <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#ImageGenPartialImageEvent">ImageGenPartialImageEvent</a>
+- <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#ImageGenStreamEventUnion">ImageGenStreamEventUnion</a>
 - <a href="https://pkg.go.dev/github.com/openai/openai-go">openai</a>.<a href="https://pkg.go.dev/github.com/openai/openai-go#ImagesResponse">ImagesResponse</a>
 
 Methods:

examples/image-streaming/main.go

@@ -0,0 +1,75 @@
+package main
+
+import (
+	"context"
+	"encoding/base64"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/openai/openai-go"
+)
+
+func main() {
+	client := openai.NewClient()
+	ctx := context.Background()
+
+	fmt.Println("Starting image streaming example...")
+
+	stream := client.Images.GenerateStreaming(ctx, openai.ImageGenerateParams{
+		Model:         openai.ImageModelGPTImage1,
+		Prompt:        "A cute baby sea otter",
+		N:             openai.Int(1),
+		Size:          openai.ImageGenerateParamsSize1024x1024,
+		PartialImages: openai.Int(3),
+	})
+
+	for stream.Next() {
+		event := stream.Current()
+
+		switch variant := event.AsAny().(type) {
+		case openai.ImageGenPartialImageEvent:
+			fmt.Printf("  Partial image %d/3 received\n", variant.PartialImageIndex+1)
+			fmt.Printf("   Size: %d characters (base64)\n", len(variant.B64JSON))
+
+			// Save partial image to file
+			filename := fmt.Sprintf("partial_%d.png", variant.PartialImageIndex+1)
+			if err := saveBase64Image(variant.B64JSON, filename); err != nil {
+				panic(fmt.Errorf("failed to save partial image: %w", err))
+			}
+			absPath, _ := filepath.Abs(filename)
+			fmt.Printf("   💾 Saved to: %s\n", absPath)
+		case openai.ImageGenCompletedEvent:
+			fmt.Printf("\n✅ Final image completed!\n")
+			fmt.Printf("   Size: %d characters (base64)\n", len(variant.B64JSON))
+
+			// Save final image to file
+			filename := "final_image.png"
+			if err := saveBase64Image(variant.B64JSON, filename); err != nil {
+				panic(fmt.Errorf("failed to save final image: %w", err))
+			}
+			absPath, _ := filepath.Abs(filename)
+			fmt.Printf("   💾 Saved to: %s\n", absPath)
+
+		default:
+			fmt.Printf("Received unknown event type: %+v\n", event)
+		}
+	}
+
+	if err := stream.Err(); err != nil {
+		panic(fmt.Errorf("error during streaming: %w", err))
+	}
+}
+
+func saveBase64Image(b64Data, filename string) error {
+	imageData, err := base64.StdEncoding.DecodeString(b64Data)
+	if err != nil {
+		return fmt.Errorf("failed to decode base64: %w", err)
+	}
+
+	if err := os.WriteFile(filename, imageData, 0644); err != nil {
+		return fmt.Errorf("failed to write file: %w", err)
+	}
+
+	return nil
+}