feat: Add orientation parameter for image and video generation; update documentation

Author: mir-ashiq

QUICK_REFERENCE.md

@@ -223,7 +223,7 @@ except Exception as e:
 ## 🔗 Links
 
 - **GitHub**: [mir-ashiq/meta-ai-python](https://github.com/mir-ashiq/metaai-api)
-- **PyPI**: [metaai-api](https://pypi.org/project/metaai-api/)
+- **PyPI**: [metaai-sdk](https://pypi.org/project/metaai-sdk/)
 - **Documentation**: [README.md](README.md)
 - **Changelog**: [CHANGELOG.md](CHANGELOG.md)
 - **Meta AI**: https://www.meta.ai/

QUICK_USAGE.md

@@ -16,13 +16,23 @@ metadata = {'file_size': result['file_size'], 'mime_type': result['mime_type']}
 response = ai.prompt("What's in this image?", media_ids=[media_id], attachment_metadata=metadata)
 print(response["message"])
 
-# 3. Generate Similar Images
-response = ai.prompt("Create similar in anime style", media_ids=[media_id], attachment_metadata=metadata, is_image_generation=True)
+# 3. Generate Similar Images with orientation
+response = ai.prompt(
+    "Create similar in anime style",
+    media_ids=[media_id],
+    attachment_metadata=metadata,
+    orientation="VERTICAL"  # Options: "LANDSCAPE", "VERTICAL" (default), "SQUARE"
+)
 for img in response["media"]:
     print(img["url"])
 
-# 4. Generate Video
-video = ai.generate_video("animate with cinematic motion", media_ids=[media_id], attachment_metadata=metadata)
+# 4. Generate Video with orientation
+video = ai.generate_video(
+    "animate with cinematic motion",
+    media_ids=[media_id],
+    attachment_metadata=metadata,
+    orientation="LANDSCAPE"  # Wide format for cinematic effect
+)
 print(video["video_urls"][0])
 ```
 

README.md

@@ -447,22 +447,29 @@ print(f"\n🎉 Generated {len(videos)} videos successfully!")
 🎉 Generated 3 videos successfully!
 ```
 
-### Example 3: Advanced Video Generation
+### Example 3: Advanced Video Generation with Orientation
 
 ```python
 from metaai_api import MetaAI
 
 ai = MetaAI(cookies=cookies)
 
-# Fine-tune generation parameters
+# Generate video with specific orientation (default is VERTICAL)
 result = ai.generate_video(
     prompt="A time-lapse of a flower blooming",
+    orientation="VERTICAL",   # Options: "LANDSCAPE", "VERTICAL", "SQUARE"
     wait_before_poll=15,      # Wait 15 seconds before checking
     max_attempts=50,          # Try up to 50 times
     wait_seconds=3,           # Wait 3 seconds between attempts
     verbose=True              # Show detailed progress
 )
 
+# Generate landscape video for widescreen
+result_landscape = ai.generate_video(
+    prompt="Panoramic view of sunset over mountains",
+    orientation="LANDSCAPE"   # Wide format (16:9)
+)
+
 if result["success"]:
     print(f"\n🎬 Your videos are ready!")
     print(f"🔗 Generated {len(result['video_urls'])} videos:")
@@ -471,6 +478,14 @@ if result["success"]:
     print(f"⏱️ Generated at: {result['timestamp']}")
 ```
 
+**Supported Video Orientations:**
+
+- `"LANDSCAPE"` - Wide/horizontal (16:9) - ideal for widescreen, cinematic content
+- `"VERTICAL"` - Tall/vertical (9:16) - ideal for mobile, stories, reels (default)
+- `"SQUARE"` - Equal dimensions (1:1) - ideal for social posts
+
+````
+
 📖 **Full Video Guide:** See [VIDEO_GENERATION_README.md](https://github.com/mir-ashiq/metaai-api/blob/main/VIDEO_GENERATION_README.md) for complete documentation!
 
 ---
@@ -525,7 +540,7 @@ if result["success"]:
     )
     if video["success"]:
         print(f"🎬 Video: {video['video_urls'][0]}")
-```
+````
 
 **Output:**
 
@@ -543,24 +558,46 @@ if result["success"]:
 
 ## 🎨 Image Generation
 
-Generate AI-powered images (requires Facebook authentication):
+Generate AI-powered images with customizable orientations (requires Facebook authentication):
 
 ```python
 from metaai_api import MetaAI
 
 # Initialize with Facebook credentials
 ai = MetaAI(fb_email="your_email@example.com", fb_password="your_password")
 
-# Generate images
+# Generate images with default orientation (VERTICAL)
 response = ai.prompt("Generate an image of a cyberpunk cityscape at night with neon lights")
 
+# Or specify orientation explicitly
+response_landscape = ai.prompt(
+    "Generate an image of a panoramic mountain landscape",
+    orientation="LANDSCAPE"  # Options: "LANDSCAPE", "VERTICAL", "SQUARE"
+)
+
+response_vertical = ai.prompt(
+    "Generate an image of a tall waterfall",
+    orientation="VERTICAL"  # Tall/portrait format (default)
+)
+
+response_square = ai.prompt(
+    "Generate an image of a centered mandala pattern",
+    orientation="SQUARE"  # Square format (1:1)
+)
+
 # Display results (Meta AI generates 4 images by default)
 print(f"🎨 Generated {len(response['media'])} images:")
 for i, image in enumerate(response['media'], 1):
     print(f"  Image {i}: {image['url']}")
     print(f"  Prompt: {image['prompt']}")
 ```
 
+**Supported Orientations:**
+
+- `"LANDSCAPE"` - Wide/horizontal format (16:9) - ideal for panoramas, landscapes
+- `"VERTICAL"` - Tall/vertical format (9:16) - ideal for portraits, mobile content (default)
+- `"SQUARE"` - Equal dimensions (1:1) - ideal for social media, profile images
+
 **Output:**
 
 ```
@@ -640,7 +677,6 @@ class MetaAI:
 **Methods:**
 
 - **`prompt(message, stream=False, new_conversation=False)`**
-
   - Send a chat message
   - Returns: `dict` with `message`, `sources`, and `media`