| | """ |
| | Image Service |
| | |
| | High-level service for image generation and editing. |
| | Abstracts all API complexity from the UI layer. |
| | """ |
| |
|
| | from typing import Callable, Optional, List |
| | from dataclasses import dataclass |
| |
|
| | from ..api.client import StackNetClient |
| |
|
| |
|
| | @dataclass |
| | class GeneratedImage: |
| | """Generated image result.""" |
| | image_url: str |
| | image_path: Optional[str] = None |
| | prompt: Optional[str] = None |
| | width: Optional[int] = None |
| | height: Optional[int] = None |
| |
|
| |
|
| | class ImageService: |
| | """ |
| | Service for image generation and editing. |
| | |
| | Provides clean interfaces for: |
| | - Text-to-image generation |
| | - Image-to-image editing/transformation |
| | """ |
| |
|
| | def __init__(self, client: Optional[StackNetClient] = None): |
| | self.client = client or StackNetClient() |
| |
|
| | async def generate_image( |
| | self, |
| | prompt: str, |
| | format_type: str = "image", |
| | on_progress: Optional[Callable[[float, str], None]] = None |
| | ) -> List[GeneratedImage]: |
| | """ |
| | Generate image from a text prompt. |
| | |
| | Args: |
| | prompt: Description of desired image |
| | format_type: Format type - "image" (generate_image_5), |
| | "multi" (generate_image_multi_5), or "3d" (generate_image_3d) |
| | on_progress: Callback for progress updates |
| | |
| | Returns: |
| | List of generated images |
| | """ |
| | |
| | if format_type == "multi": |
| | tool_name = "generate_image_multi_5" |
| | elif format_type == "3d": |
| | tool_name = "generate_image_3d" |
| | else: |
| | tool_name = "generate_image_5" |
| |
|
| | result = await self.client.submit_tool_task( |
| | tool_name=tool_name, |
| | parameters={ |
| | "prompt": prompt |
| | }, |
| | on_progress=on_progress |
| | ) |
| |
|
| | if not result.success: |
| | raise Exception(result.error or "Image generation failed") |
| |
|
| | return self._parse_image_result(result.data, prompt) |
| |
|
| | async def edit_image( |
| | self, |
| | image_url: str, |
| | edit_prompt: str, |
| | strength: float = 0.5, |
| | on_progress: Optional[Callable[[float, str], None]] = None |
| | ) -> List[GeneratedImage]: |
| | """ |
| | Edit/transform an existing image using generate_image_edit_5 tool. |
| | |
| | Args: |
| | image_url: URL to source image |
| | edit_prompt: Edit instructions |
| | strength: Edit strength (0.1 to 1.0) |
| | on_progress: Progress callback |
| | |
| | Returns: |
| | List of edited images |
| | """ |
| | result = await self.client.submit_tool_task( |
| | tool_name="generate_image_edit_5", |
| | parameters={ |
| | "prompt": edit_prompt, |
| | "image_url": image_url, |
| | "strength": strength |
| | }, |
| | on_progress=on_progress |
| | ) |
| |
|
| | if not result.success: |
| | raise Exception(result.error or "Image editing failed") |
| |
|
| | return self._parse_image_result(result.data, edit_prompt) |
| |
|
| | def _parse_image_result(self, data: dict, prompt: str) -> List[GeneratedImage]: |
| | """Parse API response into GeneratedImage objects.""" |
| | images = [] |
| |
|
| | |
| | raw_images = data.get("images", []) |
| |
|
| | if not raw_images: |
| | |
| | image_url = ( |
| | data.get("image_url") or |
| | data.get("imageUrl") or |
| | data.get("url") or |
| | data.get("content") |
| | ) |
| | if image_url: |
| | raw_images = [{"url": image_url}] |
| |
|
| | for img_data in raw_images: |
| | if isinstance(img_data, str): |
| | |
| | image_url = img_data |
| | else: |
| | image_url = ( |
| | img_data.get("url") or |
| | img_data.get("image_url") or |
| | img_data.get("imageUrl") |
| | ) |
| |
|
| | if image_url: |
| | images.append(GeneratedImage( |
| | image_url=image_url, |
| | prompt=prompt, |
| | width=img_data.get("width") if isinstance(img_data, dict) else None, |
| | height=img_data.get("height") if isinstance(img_data, dict) else None |
| | )) |
| |
|
| | return images |
| |
|
| | async def download_image(self, image: GeneratedImage) -> str: |
| | """Download an image to local file.""" |
| | if image.image_path: |
| | return image.image_path |
| |
|
| | |
| | url = image.image_url |
| | if ".png" in url: |
| | ext = ".png" |
| | elif ".jpg" in url or ".jpeg" in url: |
| | ext = ".jpg" |
| | else: |
| | ext = ".png" |
| |
|
| | filename = f"image_{hash(url) % 10000}{ext}" |
| | image.image_path = await self.client.download_file(url, filename) |
| | return image.image_path |
| |
|
| | def cleanup(self): |
| | """Clean up temporary files.""" |
| | self.client.cleanup() |
| |
|