diff --git a/examples/picture.py b/examples/picture.py
index c27b52b0da..f496c89b9c 100644
--- a/examples/picture.py
+++ b/examples/picture.py
@@ -1,4 +1,10 @@
 #!/usr/bin/env python
+"""
+Example script demonstrating image generation using DALL-E 3.
+
+This script generates an image from a text prompt using OpenAI's DALL-E 3 model
+and prints the response containing a URL to the generated image.
+"""
 
 from openai import OpenAI
 
diff --git a/examples/video.py b/examples/video.py
index ee89e64697..26c352919b 100644
--- a/examples/video.py
+++ b/examples/video.py
@@ -1,4 +1,10 @@
 #!/usr/bin/env -S poetry run python
+"""
+Example script demonstrating video generation using Sora.
+
+This async script generates a video from a text prompt using OpenAI's Sora model
+and polls until the video generation is complete.
+"""
 
 import asyncio