webscout 8.2.8__py3-none-any.whl → 8.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of webscout might be problematic. Click here for more details.

Files changed (197) hide show
  1. webscout/AIauto.py +34 -16
  2. webscout/AIbase.py +96 -37
  3. webscout/AIutel.py +491 -87
  4. webscout/Bard.py +441 -323
  5. webscout/Extra/GitToolkit/__init__.py +10 -10
  6. webscout/Extra/YTToolkit/ytapi/video.py +232 -232
  7. webscout/Litlogger/README.md +10 -0
  8. webscout/Litlogger/__init__.py +7 -59
  9. webscout/Litlogger/formats.py +4 -0
  10. webscout/Litlogger/handlers.py +103 -0
  11. webscout/Litlogger/levels.py +13 -0
  12. webscout/Litlogger/logger.py +92 -0
  13. webscout/Provider/AISEARCH/Perplexity.py +332 -358
  14. webscout/Provider/AISEARCH/felo_search.py +9 -35
  15. webscout/Provider/AISEARCH/genspark_search.py +30 -56
  16. webscout/Provider/AISEARCH/hika_search.py +4 -16
  17. webscout/Provider/AISEARCH/iask_search.py +410 -436
  18. webscout/Provider/AISEARCH/monica_search.py +4 -30
  19. webscout/Provider/AISEARCH/scira_search.py +6 -32
  20. webscout/Provider/AISEARCH/webpilotai_search.py +38 -64
  21. webscout/Provider/Blackboxai.py +155 -35
  22. webscout/Provider/ChatSandbox.py +2 -1
  23. webscout/Provider/Deepinfra.py +339 -339
  24. webscout/Provider/ExaChat.py +358 -358
  25. webscout/Provider/Gemini.py +169 -169
  26. webscout/Provider/GithubChat.py +1 -2
  27. webscout/Provider/Glider.py +3 -3
  28. webscout/Provider/HeckAI.py +172 -82
  29. webscout/Provider/LambdaChat.py +1 -0
  30. webscout/Provider/MCPCore.py +7 -3
  31. webscout/Provider/OPENAI/BLACKBOXAI.py +421 -139
  32. webscout/Provider/OPENAI/Cloudflare.py +38 -21
  33. webscout/Provider/OPENAI/FalconH1.py +457 -0
  34. webscout/Provider/OPENAI/FreeGemini.py +35 -18
  35. webscout/Provider/OPENAI/NEMOTRON.py +34 -34
  36. webscout/Provider/OPENAI/PI.py +427 -0
  37. webscout/Provider/OPENAI/Qwen3.py +304 -0
  38. webscout/Provider/OPENAI/README.md +952 -1253
  39. webscout/Provider/OPENAI/TwoAI.py +374 -0
  40. webscout/Provider/OPENAI/__init__.py +7 -1
  41. webscout/Provider/OPENAI/ai4chat.py +73 -63
  42. webscout/Provider/OPENAI/api.py +869 -644
  43. webscout/Provider/OPENAI/base.py +2 -0
  44. webscout/Provider/OPENAI/c4ai.py +34 -13
  45. webscout/Provider/OPENAI/chatgpt.py +575 -556
  46. webscout/Provider/OPENAI/chatgptclone.py +512 -487
  47. webscout/Provider/OPENAI/chatsandbox.py +11 -6
  48. webscout/Provider/OPENAI/copilot.py +258 -0
  49. webscout/Provider/OPENAI/deepinfra.py +327 -318
  50. webscout/Provider/OPENAI/e2b.py +140 -104
  51. webscout/Provider/OPENAI/exaai.py +420 -411
  52. webscout/Provider/OPENAI/exachat.py +448 -443
  53. webscout/Provider/OPENAI/flowith.py +7 -3
  54. webscout/Provider/OPENAI/freeaichat.py +12 -8
  55. webscout/Provider/OPENAI/glider.py +15 -8
  56. webscout/Provider/OPENAI/groq.py +5 -2
  57. webscout/Provider/OPENAI/heckai.py +311 -307
  58. webscout/Provider/OPENAI/llmchatco.py +9 -7
  59. webscout/Provider/OPENAI/mcpcore.py +18 -9
  60. webscout/Provider/OPENAI/multichat.py +7 -5
  61. webscout/Provider/OPENAI/netwrck.py +16 -11
  62. webscout/Provider/OPENAI/oivscode.py +290 -0
  63. webscout/Provider/OPENAI/opkfc.py +507 -496
  64. webscout/Provider/OPENAI/pydantic_imports.py +172 -0
  65. webscout/Provider/OPENAI/scirachat.py +29 -17
  66. webscout/Provider/OPENAI/sonus.py +308 -303
  67. webscout/Provider/OPENAI/standardinput.py +442 -433
  68. webscout/Provider/OPENAI/textpollinations.py +18 -11
  69. webscout/Provider/OPENAI/toolbaz.py +419 -413
  70. webscout/Provider/OPENAI/typefully.py +17 -10
  71. webscout/Provider/OPENAI/typegpt.py +21 -11
  72. webscout/Provider/OPENAI/uncovrAI.py +477 -462
  73. webscout/Provider/OPENAI/utils.py +90 -79
  74. webscout/Provider/OPENAI/venice.py +435 -425
  75. webscout/Provider/OPENAI/wisecat.py +387 -381
  76. webscout/Provider/OPENAI/writecream.py +166 -163
  77. webscout/Provider/OPENAI/x0gpt.py +26 -37
  78. webscout/Provider/OPENAI/yep.py +384 -356
  79. webscout/Provider/PI.py +2 -1
  80. webscout/Provider/TTI/README.md +55 -101
  81. webscout/Provider/TTI/__init__.py +4 -9
  82. webscout/Provider/TTI/aiarta.py +365 -0
  83. webscout/Provider/TTI/artbit.py +0 -0
  84. webscout/Provider/TTI/base.py +64 -0
  85. webscout/Provider/TTI/fastflux.py +200 -0
  86. webscout/Provider/TTI/magicstudio.py +201 -0
  87. webscout/Provider/TTI/piclumen.py +203 -0
  88. webscout/Provider/TTI/pixelmuse.py +225 -0
  89. webscout/Provider/TTI/pollinations.py +221 -0
  90. webscout/Provider/TTI/utils.py +11 -0
  91. webscout/Provider/TTS/__init__.py +2 -1
  92. webscout/Provider/TTS/base.py +159 -159
  93. webscout/Provider/TTS/openai_fm.py +129 -0
  94. webscout/Provider/TextPollinationsAI.py +308 -308
  95. webscout/Provider/TwoAI.py +239 -44
  96. webscout/Provider/UNFINISHED/Youchat.py +330 -330
  97. webscout/Provider/UNFINISHED/puterjs.py +635 -0
  98. webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
  99. webscout/Provider/Writecream.py +246 -246
  100. webscout/Provider/__init__.py +2 -2
  101. webscout/Provider/ai4chat.py +33 -8
  102. webscout/Provider/granite.py +41 -6
  103. webscout/Provider/koala.py +169 -169
  104. webscout/Provider/oivscode.py +309 -0
  105. webscout/Provider/samurai.py +3 -2
  106. webscout/Provider/scnet.py +1 -0
  107. webscout/Provider/typegpt.py +3 -3
  108. webscout/Provider/uncovr.py +368 -368
  109. webscout/client.py +70 -0
  110. webscout/litprinter/__init__.py +58 -58
  111. webscout/optimizers.py +419 -419
  112. webscout/scout/README.md +3 -1
  113. webscout/scout/core/crawler.py +134 -64
  114. webscout/scout/core/scout.py +148 -109
  115. webscout/scout/element.py +106 -88
  116. webscout/swiftcli/Readme.md +323 -323
  117. webscout/swiftcli/plugins/manager.py +9 -2
  118. webscout/version.py +1 -1
  119. webscout/zeroart/__init__.py +134 -134
  120. webscout/zeroart/effects.py +100 -100
  121. webscout/zeroart/fonts.py +1238 -1238
  122. {webscout-8.2.8.dist-info → webscout-8.3.dist-info}/METADATA +160 -35
  123. webscout-8.3.dist-info/RECORD +290 -0
  124. {webscout-8.2.8.dist-info → webscout-8.3.dist-info}/WHEEL +1 -1
  125. {webscout-8.2.8.dist-info → webscout-8.3.dist-info}/entry_points.txt +1 -0
  126. webscout/Litlogger/Readme.md +0 -175
  127. webscout/Litlogger/core/__init__.py +0 -6
  128. webscout/Litlogger/core/level.py +0 -23
  129. webscout/Litlogger/core/logger.py +0 -165
  130. webscout/Litlogger/handlers/__init__.py +0 -12
  131. webscout/Litlogger/handlers/console.py +0 -33
  132. webscout/Litlogger/handlers/file.py +0 -143
  133. webscout/Litlogger/handlers/network.py +0 -173
  134. webscout/Litlogger/styles/__init__.py +0 -7
  135. webscout/Litlogger/styles/colors.py +0 -249
  136. webscout/Litlogger/styles/formats.py +0 -458
  137. webscout/Litlogger/styles/text.py +0 -87
  138. webscout/Litlogger/utils/__init__.py +0 -6
  139. webscout/Litlogger/utils/detectors.py +0 -153
  140. webscout/Litlogger/utils/formatters.py +0 -200
  141. webscout/Provider/ChatGPTGratis.py +0 -194
  142. webscout/Provider/TTI/AiForce/README.md +0 -159
  143. webscout/Provider/TTI/AiForce/__init__.py +0 -22
  144. webscout/Provider/TTI/AiForce/async_aiforce.py +0 -224
  145. webscout/Provider/TTI/AiForce/sync_aiforce.py +0 -245
  146. webscout/Provider/TTI/FreeAIPlayground/README.md +0 -99
  147. webscout/Provider/TTI/FreeAIPlayground/__init__.py +0 -9
  148. webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py +0 -181
  149. webscout/Provider/TTI/FreeAIPlayground/sync_freeaiplayground.py +0 -180
  150. webscout/Provider/TTI/ImgSys/README.md +0 -174
  151. webscout/Provider/TTI/ImgSys/__init__.py +0 -23
  152. webscout/Provider/TTI/ImgSys/async_imgsys.py +0 -202
  153. webscout/Provider/TTI/ImgSys/sync_imgsys.py +0 -195
  154. webscout/Provider/TTI/MagicStudio/README.md +0 -101
  155. webscout/Provider/TTI/MagicStudio/__init__.py +0 -2
  156. webscout/Provider/TTI/MagicStudio/async_magicstudio.py +0 -111
  157. webscout/Provider/TTI/MagicStudio/sync_magicstudio.py +0 -109
  158. webscout/Provider/TTI/Nexra/README.md +0 -155
  159. webscout/Provider/TTI/Nexra/__init__.py +0 -22
  160. webscout/Provider/TTI/Nexra/async_nexra.py +0 -286
  161. webscout/Provider/TTI/Nexra/sync_nexra.py +0 -258
  162. webscout/Provider/TTI/PollinationsAI/README.md +0 -146
  163. webscout/Provider/TTI/PollinationsAI/__init__.py +0 -23
  164. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +0 -311
  165. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +0 -265
  166. webscout/Provider/TTI/aiarta/README.md +0 -134
  167. webscout/Provider/TTI/aiarta/__init__.py +0 -2
  168. webscout/Provider/TTI/aiarta/async_aiarta.py +0 -482
  169. webscout/Provider/TTI/aiarta/sync_aiarta.py +0 -440
  170. webscout/Provider/TTI/artbit/README.md +0 -100
  171. webscout/Provider/TTI/artbit/__init__.py +0 -22
  172. webscout/Provider/TTI/artbit/async_artbit.py +0 -155
  173. webscout/Provider/TTI/artbit/sync_artbit.py +0 -148
  174. webscout/Provider/TTI/fastflux/README.md +0 -129
  175. webscout/Provider/TTI/fastflux/__init__.py +0 -22
  176. webscout/Provider/TTI/fastflux/async_fastflux.py +0 -261
  177. webscout/Provider/TTI/fastflux/sync_fastflux.py +0 -252
  178. webscout/Provider/TTI/huggingface/README.md +0 -114
  179. webscout/Provider/TTI/huggingface/__init__.py +0 -22
  180. webscout/Provider/TTI/huggingface/async_huggingface.py +0 -199
  181. webscout/Provider/TTI/huggingface/sync_huggingface.py +0 -195
  182. webscout/Provider/TTI/piclumen/README.md +0 -161
  183. webscout/Provider/TTI/piclumen/__init__.py +0 -23
  184. webscout/Provider/TTI/piclumen/async_piclumen.py +0 -268
  185. webscout/Provider/TTI/piclumen/sync_piclumen.py +0 -233
  186. webscout/Provider/TTI/pixelmuse/README.md +0 -79
  187. webscout/Provider/TTI/pixelmuse/__init__.py +0 -4
  188. webscout/Provider/TTI/pixelmuse/async_pixelmuse.py +0 -249
  189. webscout/Provider/TTI/pixelmuse/sync_pixelmuse.py +0 -182
  190. webscout/Provider/TTI/talkai/README.md +0 -139
  191. webscout/Provider/TTI/talkai/__init__.py +0 -4
  192. webscout/Provider/TTI/talkai/async_talkai.py +0 -229
  193. webscout/Provider/TTI/talkai/sync_talkai.py +0 -207
  194. webscout/Provider/UNFINISHED/oivscode.py +0 -351
  195. webscout-8.2.8.dist-info/RECORD +0 -334
  196. {webscout-8.2.8.dist-info → webscout-8.3.dist-info}/licenses/LICENSE.md +0 -0
  197. {webscout-8.2.8.dist-info → webscout-8.3.dist-info}/top_level.txt +0 -0
@@ -1,2 +0,0 @@
1
- from .async_aiarta import *
2
- from .sync_aiarta import *
@@ -1,482 +0,0 @@
1
- """
2
- AsyncAIArtaImager - Your go-to async provider for generating fire images with AI Arta! ⚡
3
-
4
- Examples:
5
- >>> from webscout import AsyncAIArtaImager
6
- >>> import asyncio
7
- >>>
8
- >>> async def example():
9
- ... # Initialize with logging
10
- ... provider = AsyncAIArtaImager(logging=True)
11
- ...
12
- ... # Generate a single image
13
- ... images = await provider.generate("A beautiful sunset over mountains")
14
- ... paths = await provider.save(images)
15
- ...
16
- ... # Generate multiple images with parameters
17
- ... images = await provider.generate(
18
- ... prompt="Epic dragon in cyberpunk city",
19
- ... amount=2,
20
- ... model="fantasy_art",
21
- ... negative_prompt="ugly, deformed",
22
- ... guidance_scale=7,
23
- ... num_inference_steps=30
24
- ... )
25
- ... paths = await provider.save(images, name="dragon", dir="outputs")
26
- >>>
27
- >>> # Run the example
28
- >>> asyncio.run(example())
29
- """
30
-
31
- import aiohttp
32
- import asyncio
33
- import json
34
- import os
35
- import time
36
- from pathlib import Path
37
- from typing import List, Optional, Union, Dict, Any, AsyncGenerator
38
- import aiofiles
39
-
40
- from webscout.AIbase import AsyncImageProvider
41
- from webscout.litagent import LitAgent
42
-
43
- class AsyncAIArtaImager(AsyncImageProvider):
44
- """Your go-to async provider for generating fire images with AI Arta! ⚡
45
-
46
- Examples:
47
- >>> provider = AsyncAIArtaImager()
48
- >>> async def example():
49
- ... # Basic usage
50
- ... images = await provider.generate("Cool art")
51
- ... paths = await provider.save(images)
52
- >>>
53
- >>> # Advanced usage
54
- >>> provider = AsyncAIArtaImager(timeout=120)
55
- >>> async def example():
56
- ... images = await provider.generate(
57
- ... prompt="Epic dragon",
58
- ... amount=2,
59
- ... model="fantasy_art",
60
- ... negative_prompt="ugly, deformed"
61
- ... )
62
- ... paths = await provider.save(images, name="dragon", dir="my_art")
63
- """
64
-
65
- # API endpoints
66
- url = "https://img-gen-prod.ai-arta.com"
67
- auth_url = "https://www.googleapis.com/identitytoolkit/v3/relyingparty/signupNewUser?key=AIzaSyB3-71wG0fIt0shj0ee4fvx1shcjJHGrrQ"
68
- token_refresh_url = "https://securetoken.googleapis.com/v1/token?key=AIzaSyB3-71wG0fIt0shj0ee4fvx1shcjJHGrrQ"
69
- image_generation_url = "https://img-gen-prod.ai-arta.com/api/v1/text2image"
70
- status_check_url = "https://img-gen-prod.ai-arta.com/api/v1/text2image/{record_id}/status"
71
-
72
- # Available models
73
- AVAILABLE_MODELS = {
74
- "flux": "Flux",
75
- "medieval": "Medieval",
76
- "vincent_van_gogh": "Vincent Van Gogh",
77
- "f_dev": "F Dev",
78
- "low_poly": "Low Poly",
79
- "dreamshaper_xl": "Dreamshaper-xl",
80
- "anima_pencil_xl": "Anima-pencil-xl",
81
- "biomech": "Biomech",
82
- "trash_polka": "Trash Polka",
83
- "no_style": "No Style",
84
- "cheyenne_xl": "Cheyenne-xl",
85
- "chicano": "Chicano",
86
- "embroidery_tattoo": "Embroidery tattoo",
87
- "red_and_black": "Red and Black",
88
- "fantasy_art": "Fantasy Art",
89
- "watercolor": "Watercolor",
90
- "dotwork": "Dotwork",
91
- "old_school_colored": "Old school colored",
92
- "realistic_tattoo": "Realistic tattoo",
93
- "japanese_2": "Japanese_2",
94
- "realistic_stock_xl": "Realistic-stock-xl",
95
- "f_pro": "F Pro",
96
- "revanimated": "RevAnimated",
97
- "katayama_mix_xl": "Katayama-mix-xl",
98
- "sdxl_l": "SDXL L",
99
- "cor_epica_xl": "Cor-epica-xl",
100
- "anime_tattoo": "Anime tattoo",
101
- "new_school": "New School",
102
- "death_metal": "Death metal",
103
- "old_school": "Old School",
104
- "juggernaut_xl": "Juggernaut-xl",
105
- "photographic": "Photographic",
106
- "sdxl_1_0": "SDXL 1.0",
107
- "graffiti": "Graffiti",
108
- "mini_tattoo": "Mini tattoo",
109
- "surrealism": "Surrealism",
110
- "neo_traditional": "Neo-traditional",
111
- "on_limbs_black": "On limbs black",
112
- # "yamers_realistic_xl": "Yamers-realistic-xl",
113
- # "pony_xl": "Pony-xl",
114
- # "playground_xl": "Playground-xl",
115
- # "anything_xl": "Anything-xl",
116
- # "flame_design": "Flame design",
117
- # "kawaii": "Kawaii",
118
- # "cinematic_art": "Cinematic Art",
119
- # "professional": "Professional",
120
- # "flux_black_ink": "Flux Black Ink"
121
- }
122
- models = list(AVAILABLE_MODELS.keys())
123
-
124
- def __init__(self, timeout: int = 60, proxies: dict = None, logging: bool = True):
125
- """Initialize your async AIArtaImager provider with custom settings ⚙️
126
-
127
- Args:
128
- timeout (int): HTTP request timeout in seconds (default: 60)
129
- proxies (dict, optional): Proxy configuration for requests
130
- logging (bool): Enable/disable logging (default: True)
131
- """
132
- self.headers = {
133
- "Accept": "application/json",
134
- "Accept-Language": "en-US,en;q=0.5",
135
- "User-Agent": LitAgent().random()
136
- }
137
- self.timeout = timeout
138
- self.proxies = proxies
139
- self.prompt: str = "AI-generated image - webscout"
140
- self.image_extension: str = "png"
141
- self.logging = logging
142
-
143
- if self.logging and False: # Disabled logger
144
- print("AsyncAIArtaImager initialized! Ready to create some fire art! 🚀")
145
-
146
- async def get_auth_file(self) -> Path:
147
- """Get path to authentication file"""
148
- path = Path(os.path.join(os.path.expanduser("~"), ".ai_arta_cookies"))
149
- path.mkdir(exist_ok=True)
150
- filename = f"auth_{self.__class__.__name__}.json"
151
- return path / filename
152
-
153
- async def create_token(self, path: Path) -> Dict[str, Any]:
154
- """Create a new authentication token"""
155
- # Step 1: Generate Authentication Token
156
- auth_payload = {"clientType": "CLIENT_TYPE_ANDROID"}
157
-
158
- async with aiohttp.ClientSession(headers=self.headers) as session:
159
- async with session.post(
160
- self.auth_url,
161
- json=auth_payload,
162
- timeout=self.timeout,
163
- proxy=self.proxies.get('http') if self.proxies else None
164
- ) as response:
165
- response.raise_for_status()
166
- auth_data = await response.json()
167
-
168
- auth_token = auth_data.get("idToken")
169
-
170
- if not auth_token:
171
- if self.logging:
172
- print("Failed to obtain authentication token 😢")
173
- raise Exception("Failed to obtain authentication token.")
174
-
175
- async with aiofiles.open(path, 'w') as f:
176
- await f.write(json.dumps(auth_data))
177
-
178
- return auth_data
179
-
180
- async def refresh_token(self, refresh_token: str) -> tuple[str, str]:
181
- """Refresh authentication token"""
182
- payload = {
183
- "grant_type": "refresh_token",
184
- "refresh_token": refresh_token,
185
- }
186
-
187
- async with aiohttp.ClientSession(headers=self.headers) as session:
188
- async with session.post(
189
- self.token_refresh_url,
190
- data=payload,
191
- timeout=self.timeout,
192
- proxy=self.proxies.get('http') if self.proxies else None
193
- ) as response:
194
- response.raise_for_status()
195
- response_data = await response.json()
196
-
197
- return response_data.get("id_token"), response_data.get("refresh_token")
198
-
199
- async def read_and_refresh_token(self) -> Dict[str, Any]:
200
- """Read token from file and refresh if needed"""
201
- path = await self.get_auth_file()
202
-
203
- if path.is_file():
204
- async with aiofiles.open(path, 'r') as f:
205
- auth_data = json.loads(await f.read())
206
-
207
- diff = time.time() - os.path.getmtime(path)
208
- expires_in = int(auth_data.get("expiresIn"))
209
-
210
- if diff < expires_in:
211
- if diff > expires_in / 2:
212
- # Refresh token if it's older than half its lifetime
213
- if self.logging:
214
- print("Refreshing authentication token... 🔄")
215
- auth_data["idToken"], auth_data["refreshToken"] = await self.refresh_token(
216
- auth_data.get("refreshToken")
217
- )
218
- async with aiofiles.open(path, 'w') as f:
219
- await f.write(json.dumps(auth_data))
220
- return auth_data
221
-
222
- # Create new token if file doesn't exist or token expired
223
- if self.logging:
224
- print("Creating new authentication token... 🔑")
225
- return await self.create_token(path)
226
-
227
- def get_model(self, model_name: str) -> str:
228
- """Get actual model name from alias"""
229
- if model_name.lower() in self.AVAILABLE_MODELS:
230
- return self.AVAILABLE_MODELS[model_name.lower()]
231
- return model_name
232
-
233
- async def generate(
234
- self,
235
- prompt: str,
236
- amount: int = 1,
237
- model: str = "Flux",
238
- negative_prompt: str = "blurry, deformed hands, ugly",
239
- guidance_scale: int = 7,
240
- num_inference_steps: int = 30,
241
- aspect_ratio: str = "1:1",
242
- max_retries: int = 3,
243
- retry_delay: int = 5,
244
- **kwargs
245
- ) -> List[bytes]:
246
- """Generate some fire images from your prompt asynchronously! ⚡
247
-
248
- Examples:
249
- >>> provider = AsyncAIArtaImager()
250
- >>> async def example():
251
- ... # Basic usage
252
- ... images = await provider.generate("Cool art")
253
- ... # Advanced usage
254
- ... images = await provider.generate(
255
- ... prompt="Epic dragon",
256
- ... amount=2,
257
- ... model="fantasy_art",
258
- ... negative_prompt="ugly, deformed"
259
- ... )
260
-
261
- Args:
262
- prompt (str): Your image description
263
- amount (int): How many images you want (default: 1)
264
- model (str): Model to use - check AVAILABLE_MODELS (default: "flux")
265
- negative_prompt (str): What you don't want in the image
266
- guidance_scale (int): Controls how closely the model follows your prompt
267
- num_inference_steps (int): More steps = better quality but slower
268
- aspect_ratio (str): Image aspect ratio (default: "1:1")
269
- max_retries (int): Max retry attempts if something fails
270
- retry_delay (int): Seconds to wait between retries
271
- **kwargs: Additional parameters for future compatibility
272
-
273
- Returns:
274
- List[bytes]: Your generated images
275
-
276
- Raises:
277
- ValueError: If the inputs ain't valid
278
- Exception: If the API calls fail after retries
279
- """
280
- if not prompt:
281
- raise ValueError("Yo fam, the prompt can't be empty! 🤔")
282
- if not isinstance(amount, int) or amount < 1:
283
- raise ValueError("Amount needs to be a positive number! 📈")
284
-
285
- model_name = self.get_model(model)
286
- self.prompt = prompt
287
- response = []
288
-
289
- if self.logging:
290
- print(f"Generating {amount} images with {model_name}... 🎨")
291
-
292
- # Step 1: Get Authentication Token
293
- auth_data = await self.read_and_refresh_token()
294
-
295
- # Headers for generation requests
296
- gen_headers = {
297
- "Authorization": auth_data.get("idToken"),
298
- }
299
-
300
- async with aiohttp.ClientSession(headers={**self.headers, **gen_headers}) as session:
301
- for i in range(amount):
302
- # Step 2: Generate Image
303
- image_payload = {
304
- "prompt": prompt,
305
- "negative_prompt": negative_prompt,
306
- "style": model_name,
307
- "images_num": "1", # Generate 1 at a time
308
- "cfg_scale": str(guidance_scale),
309
- "steps": str(num_inference_steps),
310
- "aspect_ratio": aspect_ratio,
311
- }
312
-
313
- for attempt in range(max_retries):
314
- try:
315
- if self.logging:
316
- print(f"Starting generation for image {i+1}/{amount}... ⏳")
317
-
318
- # Submit generation request
319
- async with session.post(
320
- self.image_generation_url,
321
- data=image_payload,
322
- timeout=self.timeout,
323
- proxy=self.proxies.get('http') if self.proxies else None
324
- ) as image_response:
325
- image_response.raise_for_status()
326
- image_data = await image_response.json()
327
-
328
- record_id = image_data.get("record_id")
329
-
330
- if not record_id:
331
- if self.logging:
332
- print("Failed to initiate image generation 😢")
333
- raise Exception(f"Failed to initiate image generation: {image_data}")
334
-
335
- # Step 3: Check Generation Status
336
- status_url = self.status_check_url.format(record_id=record_id)
337
-
338
- counter = 0
339
- dots = [".", "..", "...", "...."]
340
-
341
- while True:
342
- async with session.get(
343
- status_url,
344
- timeout=self.timeout,
345
- proxy=self.proxies.get('http') if self.proxies else None
346
- ) as status_response:
347
- status_data = await status_response.json()
348
-
349
- status = status_data.get("status")
350
-
351
- if status == "DONE":
352
- image_urls = [image["url"] for image in status_data.get("response", [])]
353
-
354
- if not image_urls:
355
- if self.logging:
356
- print("No image URLs in response 😢")
357
- raise Exception("No image URLs in response")
358
-
359
- # Download the generated image
360
- async with session.get(image_urls[0]) as img_response:
361
- img_response.raise_for_status()
362
- response.append(await img_response.read())
363
-
364
- if self.logging:
365
- print(f"Successfully generated image {i+1}/{amount}! 🎨")
366
- break
367
-
368
- elif status in ("IN_QUEUE", "IN_PROGRESS"):
369
- status_text = "Waiting" if status == "IN_QUEUE" else "Generating"
370
- if self.logging:
371
- print(f"{status_text}{dots[counter % 4]}")
372
- await asyncio.sleep(5) # Poll every 5 seconds
373
- counter += 1
374
-
375
- else:
376
- if self.logging:
377
- print(f"Generation failed with status: {status} 😢")
378
- raise Exception(f"Image generation failed with status: {status}")
379
-
380
- # If we got here, we successfully generated an image
381
- break
382
-
383
- except Exception as e:
384
- if attempt == max_retries - 1:
385
- if self.logging:
386
- print(f"Failed after {max_retries} attempts: {e} 😢")
387
- raise
388
- else:
389
- if self.logging:
390
- print(f"Attempt {attempt + 1} failed. Retrying in {retry_delay} seconds... 🔄")
391
- await asyncio.sleep(retry_delay)
392
-
393
- if self.logging:
394
- print(f"Successfully generated {len(response)} images! 🎉")
395
- return response
396
-
397
- async def save(
398
- self,
399
- response: Union[List[bytes], AsyncGenerator[bytes, None]],
400
- name: Optional[str] = None,
401
- dir: Optional[Union[str, Path]] = None,
402
- filenames_prefix: str = "",
403
- ) -> List[str]:
404
- """Save your fire generated images asynchronously! 💾
405
-
406
- Examples:
407
- >>> provider = AsyncAIArtaImager()
408
- >>> async def example():
409
- ... images = await provider.generate("Cool art")
410
- ... # Save with default settings
411
- ... paths = await provider.save(images)
412
- ... # Save with custom name and directory
413
- ... paths = await provider.save(
414
- ... images,
415
- ... name="my_art",
416
- ... dir="my_images",
417
- ... filenames_prefix="test_"
418
- ... )
419
-
420
- Args:
421
- response (Union[List[bytes], AsyncGenerator[bytes, None]]): Your generated images
422
- name (Optional[str]): Custom name for your images
423
- dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
424
- filenames_prefix (str): Prefix for your image files
425
-
426
- Returns:
427
- List[str]: Paths to your saved images
428
- """
429
- save_dir = dir if dir else os.getcwd()
430
- if not os.path.exists(save_dir):
431
- os.makedirs(save_dir)
432
- if self.logging:
433
- print(f"Created directory: {save_dir} 📁")
434
-
435
- name = self.prompt if name is None else name
436
-
437
- # Clean up name for filename use
438
- safe_name = "".join(c if c.isalnum() or c in "_-" else "_" for c in name)
439
- safe_name = safe_name[:50] # Truncate if too long
440
-
441
- # Handle both List[bytes] and AsyncGenerator
442
- if isinstance(response, list):
443
- image_list = response
444
- else:
445
- image_list = [chunk async for chunk in response]
446
-
447
- if self.logging:
448
- print(f"Saving {len(image_list)} images... 💾")
449
-
450
- saved_paths = []
451
-
452
- async def save_single_image(image_bytes: bytes, index: int) -> str:
453
- filename = f"{filenames_prefix}{safe_name}_{index}.{self.image_extension}"
454
- filepath = os.path.join(save_dir, filename)
455
-
456
- async with aiofiles.open(filepath, "wb") as f:
457
- await f.write(image_bytes)
458
-
459
- if self.logging:
460
- print(f"Saved image to: {filepath} 💾")
461
- return filename
462
-
463
- tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
464
- saved_paths = await asyncio.gather(*tasks)
465
-
466
- if self.logging:
467
- print(f"Images saved successfully! Check {dir} 🎉")
468
- return saved_paths
469
-
470
-
471
- if __name__ == "__main__":
472
- # Example usage
473
- async def main():
474
- provider = AsyncAIArtaImager()
475
- try:
476
- images = await provider.generate("A beautiful sunset over mountains", amount=1)
477
- paths = await provider.save(images, dir="generated_images")
478
- print(f"Images saved to: {paths}")
479
- except Exception as e:
480
- print(f"An error occurred: {e}")
481
-
482
- asyncio.run(main())