deapi-sdk 0.6.1__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.
Files changed (47) hide show
  1. deapi_sdk/__init__.py +409 -0
  2. deapi_sdk/_cards.py +313 -0
  3. deapi_sdk/_client.py +411 -0
  4. deapi_sdk/_config.py +77 -0
  5. deapi_sdk/_constants.py +61 -0
  6. deapi_sdk/_download.py +37 -0
  7. deapi_sdk/_exceptions.py +184 -0
  8. deapi_sdk/_files.py +59 -0
  9. deapi_sdk/_payload.py +50 -0
  10. deapi_sdk/_polling.py +157 -0
  11. deapi_sdk/_realtime/__init__.py +7 -0
  12. deapi_sdk/_realtime/_discovery.py +43 -0
  13. deapi_sdk/_realtime/_engine.py +419 -0
  14. deapi_sdk/_realtime/_protocol.py +152 -0
  15. deapi_sdk/_realtime/_session.py +529 -0
  16. deapi_sdk/_types.py +31 -0
  17. deapi_sdk/_version.py +3 -0
  18. deapi_sdk/py.typed +0 -0
  19. deapi_sdk/resources/__init__.py +35 -0
  20. deapi_sdk/resources/account.py +149 -0
  21. deapi_sdk/resources/audio.py +386 -0
  22. deapi_sdk/resources/embeddings.py +116 -0
  23. deapi_sdk/resources/images.py +616 -0
  24. deapi_sdk/resources/keys.py +277 -0
  25. deapi_sdk/resources/models.py +161 -0
  26. deapi_sdk/resources/ocr.py +152 -0
  27. deapi_sdk/resources/prompts.py +137 -0
  28. deapi_sdk/resources/transcription.py +308 -0
  29. deapi_sdk/resources/video.py +985 -0
  30. deapi_sdk/transcript.py +142 -0
  31. deapi_sdk/types/__init__.py +68 -0
  32. deapi_sdk/types/account.py +115 -0
  33. deapi_sdk/types/audio.py +35 -0
  34. deapi_sdk/types/common.py +174 -0
  35. deapi_sdk/types/embeddings.py +11 -0
  36. deapi_sdk/types/images.py +40 -0
  37. deapi_sdk/types/keys.py +53 -0
  38. deapi_sdk/types/ocr.py +14 -0
  39. deapi_sdk/types/prompts.py +26 -0
  40. deapi_sdk/types/transcription.py +14 -0
  41. deapi_sdk/types/video.py +84 -0
  42. deapi_sdk/types/websocket.py +36 -0
  43. deapi_sdk/webhook.py +159 -0
  44. deapi_sdk-0.6.1.dist-info/METADATA +644 -0
  45. deapi_sdk-0.6.1.dist-info/RECORD +47 -0
  46. deapi_sdk-0.6.1.dist-info/WHEEL +4 -0
  47. deapi_sdk-0.6.1.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,616 @@
1
+ from __future__ import annotations
2
+
3
+ from typing import Any
4
+
5
+ from deapi_sdk._cards import IMAGE_KEYS, afill_payload, fill_payload
6
+ from deapi_sdk._client import AsyncHTTPClient, SyncHTTPClient
7
+ from deapi_sdk._files import FileInput, normalize_file, normalize_files
8
+ from deapi_sdk._payload import drop_none, form_bool, webhook_fields
9
+ from deapi_sdk._polling import AsyncJob, Job
10
+ from deapi_sdk.types.common import PriceResult
11
+ from deapi_sdk.types.images import LoraWeight
12
+
13
+
14
+ class Images:
15
+ """Sync image generation and transformation resource."""
16
+
17
+ def __init__(self, client: SyncHTTPClient) -> None:
18
+ self._client = client
19
+
20
+ def generate(
21
+ self,
22
+ *,
23
+ prompt: str,
24
+ model: str,
25
+ width: int | None = None,
26
+ height: int | None = None,
27
+ seed: int | None = None,
28
+ negative_prompt: str | None = None,
29
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
30
+ guidance: float | None = None,
31
+ steps: int | None = None,
32
+ quality: str | None = None,
33
+ enhance_prompt: bool | None = None,
34
+ webhook_url: str | None = None,
35
+ webhook_secret: str | None = None,
36
+ ) -> Job:
37
+ """Submit a text-to-image generation job.
38
+
39
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's ``info.defaults`` (one catalogue
40
+ request per client, cached; disable with ``fill_model_defaults=False``) and ``seed`` defaults to -1
41
+ (random). ``seed``, ``steps`` and ``guidance`` are otherwise only sent when set.
42
+ ``quality`` is a model tier such as
43
+ ``"low"``/``"medium"``/``"high"``. ``enhance_prompt=True`` boosts the prompt inside
44
+ the job (the boost fee is billed on the job).
45
+ """
46
+ url = self._client._resolve_endpoint("txt2img")
47
+ payload = _build_txt2img_payload(
48
+ prompt=prompt, model=model, width=width, height=height, seed=seed,
49
+ negative_prompt=negative_prompt, loras=loras, guidance=guidance,
50
+ steps=steps, quality=quality, enhance_prompt=enhance_prompt,
51
+ webhook_url=webhook_url, webhook_secret=webhook_secret,
52
+ )
53
+ payload = fill_payload(self._client, payload, IMAGE_KEYS, seed=True)
54
+ resp = self._client.post(url, json=payload)
55
+ request_id = resp["data"]["request_id"]
56
+ status_url = self._client._resolve_endpoint("request_status")
57
+ return Job(request_id, self._client, status_url)
58
+
59
+ def generate_price(
60
+ self,
61
+ *,
62
+ prompt: str,
63
+ model: str,
64
+ width: int | None = None,
65
+ height: int | None = None,
66
+ seed: int | None = None,
67
+ negative_prompt: str | None = None,
68
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
69
+ guidance: float | None = None,
70
+ steps: int | None = None,
71
+ quality: str | None = None,
72
+ ) -> PriceResult:
73
+ """Calculate price for text-to-image generation.
74
+
75
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's
76
+ ``info.defaults`` (one catalogue request per
77
+ client, cached; disable with ``fill_model_defaults=False``); ``seed`` defaults to -1 (random).
78
+ """
79
+ url = self._client._resolve_endpoint("txt2img_price")
80
+ payload = _build_txt2img_payload(
81
+ prompt=prompt, model=model, width=width, height=height, seed=seed,
82
+ negative_prompt=negative_prompt, loras=loras, guidance=guidance,
83
+ steps=steps, quality=quality,
84
+ )
85
+ payload = fill_payload(self._client, payload, IMAGE_KEYS, seed=True)
86
+ resp = self._client.post(url, json=payload)
87
+ return PriceResult.model_validate(resp.get("data", resp))
88
+
89
+ def transform(
90
+ self,
91
+ *,
92
+ prompt: str,
93
+ model: str,
94
+ steps: int | None = None,
95
+ seed: int | None = None,
96
+ image: FileInput | None = None,
97
+ images: list[FileInput] | None = None,
98
+ negative_prompt: str | None = None,
99
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
100
+ width: int | None = None,
101
+ height: int | None = None,
102
+ guidance: float | None = None,
103
+ quality: str | None = None,
104
+ enhance_prompt: bool | None = None,
105
+ webhook_url: str | None = None,
106
+ webhook_secret: str | None = None,
107
+ ) -> Job:
108
+ """Submit an image-to-image transformation (edit) job.
109
+
110
+ Pass either ``image`` (one source) or ``images`` (several, sent as ``images[]``;
111
+ the per-model maximum is ``max_input_images`` on the model card) -- not both.
112
+
113
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's
114
+ ``info.defaults`` (one catalogue request per
115
+ client, cached; disable with ``fill_model_defaults=False``); ``seed`` defaults to -1 (random).
116
+ """
117
+ url = self._client._resolve_endpoint("img2img")
118
+ data, files = _build_img2img_multipart(
119
+ prompt=prompt, model=model, steps=steps, seed=seed,
120
+ image=image, images=images, negative_prompt=negative_prompt,
121
+ loras=loras, width=width, height=height, guidance=guidance,
122
+ quality=quality, enhance_prompt=enhance_prompt,
123
+ webhook_url=webhook_url, webhook_secret=webhook_secret,
124
+ )
125
+ data = fill_payload(self._client, data, IMAGE_KEYS, seed=True, form=True)
126
+ resp = self._client.post(url, data=data, files=files)
127
+ request_id = resp["data"]["request_id"]
128
+ status_url = self._client._resolve_endpoint("request_status")
129
+ return Job(request_id, self._client, status_url)
130
+
131
+ def transform_price(
132
+ self,
133
+ *,
134
+ prompt: str,
135
+ model: str,
136
+ steps: int | None = None,
137
+ seed: int | None = None,
138
+ image: FileInput | None = None,
139
+ images: list[FileInput] | None = None,
140
+ negative_prompt: str | None = None,
141
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
142
+ width: int | None = None,
143
+ height: int | None = None,
144
+ guidance: float | None = None,
145
+ quality: str | None = None,
146
+ ) -> PriceResult:
147
+ """Calculate price for an image edit.
148
+
149
+ Some models price by the input size, so pass the same ``image``/``images`` the job
150
+ will use. Without a source image the quote is sent as JSON.
151
+
152
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's
153
+ ``info.defaults`` (one catalogue request per
154
+ client, cached; disable with ``fill_model_defaults=False``); ``seed`` defaults to -1 (random).
155
+ """
156
+ url = self._client._resolve_endpoint("img2img_price")
157
+ json_body, data, files = _build_img2img_price_request(
158
+ prompt=prompt, model=model, steps=steps, seed=seed, image=image, images=images,
159
+ negative_prompt=negative_prompt, loras=loras, width=width, height=height,
160
+ guidance=guidance, quality=quality,
161
+ )
162
+ payload = json_body if json_body is not None else data
163
+ assert payload is not None # one of json_body / data is always set
164
+ fill_payload(self._client, payload, IMAGE_KEYS, seed=True, form=json_body is None)
165
+ resp = self._client.post(url, json=json_body, data=data, files=files)
166
+ return PriceResult.model_validate(resp.get("data", resp))
167
+
168
+ def upscale(
169
+ self,
170
+ *,
171
+ image: FileInput,
172
+ model: str,
173
+ webhook_url: str | None = None,
174
+ webhook_secret: str | None = None,
175
+ ) -> Job:
176
+ """Submit an image upscale job."""
177
+ url = self._client._resolve_endpoint("img_upscale")
178
+ data = {"model": model, **webhook_fields(webhook_url, webhook_secret)}
179
+ files = [("image", normalize_file(image, "image"))]
180
+ resp = self._client.post(url, data=data, files=files)
181
+ request_id = resp["data"]["request_id"]
182
+ status_url = self._client._resolve_endpoint("request_status")
183
+ return Job(request_id, self._client, status_url)
184
+
185
+ def upscale_price(
186
+ self,
187
+ *,
188
+ model: str,
189
+ image: FileInput | None = None,
190
+ width: int | None = None,
191
+ height: int | None = None,
192
+ ) -> PriceResult:
193
+ """Calculate price for image upscale (pass the image, or its width and height)."""
194
+ url = self._client._resolve_endpoint("img_upscale_price")
195
+ json_body, data, files = _build_size_price_request(model, image, width, height)
196
+ resp = self._client.post(url, json=json_body, data=data, files=files)
197
+ return PriceResult.model_validate(resp.get("data", resp))
198
+
199
+ def remove_background(
200
+ self,
201
+ *,
202
+ image: FileInput,
203
+ model: str,
204
+ webhook_url: str | None = None,
205
+ webhook_secret: str | None = None,
206
+ ) -> Job:
207
+ """Submit an image background removal job."""
208
+ url = self._client._resolve_endpoint("img_rmbg")
209
+ data = {"model": model, **webhook_fields(webhook_url, webhook_secret)}
210
+ files = [("image", normalize_file(image, "image"))]
211
+ resp = self._client.post(url, data=data, files=files)
212
+ request_id = resp["data"]["request_id"]
213
+ status_url = self._client._resolve_endpoint("request_status")
214
+ return Job(request_id, self._client, status_url)
215
+
216
+ def remove_background_price(
217
+ self,
218
+ *,
219
+ model: str,
220
+ image: FileInput | None = None,
221
+ width: int | None = None,
222
+ height: int | None = None,
223
+ ) -> PriceResult:
224
+ """Calculate price for image background removal (pass the image, or its width and height)."""
225
+ url = self._client._resolve_endpoint("img_rmbg_price")
226
+ json_body, data, files = _build_size_price_request(model, image, width, height)
227
+ resp = self._client.post(url, json=json_body, data=data, files=files)
228
+ return PriceResult.model_validate(resp.get("data", resp))
229
+
230
+
231
+ class AsyncImages:
232
+ """Async image generation and transformation resource."""
233
+
234
+ def __init__(self, client: AsyncHTTPClient) -> None:
235
+ self._client = client
236
+
237
+ async def generate(
238
+ self,
239
+ *,
240
+ prompt: str,
241
+ model: str,
242
+ width: int | None = None,
243
+ height: int | None = None,
244
+ seed: int | None = None,
245
+ negative_prompt: str | None = None,
246
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
247
+ guidance: float | None = None,
248
+ steps: int | None = None,
249
+ quality: str | None = None,
250
+ enhance_prompt: bool | None = None,
251
+ webhook_url: str | None = None,
252
+ webhook_secret: str | None = None,
253
+ ) -> AsyncJob:
254
+ """Submit a text-to-image generation job.
255
+
256
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's ``info.defaults`` (one catalogue
257
+ request per client, cached; disable with ``fill_model_defaults=False``) and ``seed`` defaults to -1
258
+ (random). ``seed``, ``steps`` and ``guidance`` are otherwise only sent when set.
259
+ ``quality`` is a model tier such as
260
+ ``"low"``/``"medium"``/``"high"``. ``enhance_prompt=True`` boosts the prompt inside
261
+ the job (the boost fee is billed on the job).
262
+ """
263
+ url = self._client._resolve_endpoint("txt2img")
264
+ payload = _build_txt2img_payload(
265
+ prompt=prompt, model=model, width=width, height=height, seed=seed,
266
+ negative_prompt=negative_prompt, loras=loras, guidance=guidance,
267
+ steps=steps, quality=quality, enhance_prompt=enhance_prompt,
268
+ webhook_url=webhook_url, webhook_secret=webhook_secret,
269
+ )
270
+ payload = await afill_payload(self._client, payload, IMAGE_KEYS, seed=True)
271
+ resp = await self._client.post(url, json=payload)
272
+ request_id = resp["data"]["request_id"]
273
+ status_url = self._client._resolve_endpoint("request_status")
274
+ return AsyncJob(request_id, self._client, status_url)
275
+
276
+ async def generate_price(
277
+ self,
278
+ *,
279
+ prompt: str,
280
+ model: str,
281
+ width: int | None = None,
282
+ height: int | None = None,
283
+ seed: int | None = None,
284
+ negative_prompt: str | None = None,
285
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
286
+ guidance: float | None = None,
287
+ steps: int | None = None,
288
+ quality: str | None = None,
289
+ ) -> PriceResult:
290
+ """Calculate price for text-to-image generation.
291
+
292
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's
293
+ ``info.defaults`` (one catalogue request per
294
+ client, cached; disable with ``fill_model_defaults=False``); ``seed`` defaults to -1 (random).
295
+ """
296
+ url = self._client._resolve_endpoint("txt2img_price")
297
+ payload = _build_txt2img_payload(
298
+ prompt=prompt, model=model, width=width, height=height, seed=seed,
299
+ negative_prompt=negative_prompt, loras=loras, guidance=guidance,
300
+ steps=steps, quality=quality,
301
+ )
302
+ payload = await afill_payload(self._client, payload, IMAGE_KEYS, seed=True)
303
+ resp = await self._client.post(url, json=payload)
304
+ return PriceResult.model_validate(resp.get("data", resp))
305
+
306
+ async def transform(
307
+ self,
308
+ *,
309
+ prompt: str,
310
+ model: str,
311
+ steps: int | None = None,
312
+ seed: int | None = None,
313
+ image: FileInput | None = None,
314
+ images: list[FileInput] | None = None,
315
+ negative_prompt: str | None = None,
316
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
317
+ width: int | None = None,
318
+ height: int | None = None,
319
+ guidance: float | None = None,
320
+ quality: str | None = None,
321
+ enhance_prompt: bool | None = None,
322
+ webhook_url: str | None = None,
323
+ webhook_secret: str | None = None,
324
+ ) -> AsyncJob:
325
+ """Submit an image-to-image transformation (edit) job.
326
+
327
+ Pass either ``image`` (one source) or ``images`` (several, sent as ``images[]``;
328
+ the per-model maximum is ``max_input_images`` on the model card) -- not both.
329
+
330
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's
331
+ ``info.defaults`` (one catalogue request per
332
+ client, cached; disable with ``fill_model_defaults=False``); ``seed`` defaults to -1 (random).
333
+ """
334
+ url = self._client._resolve_endpoint("img2img")
335
+ data, files = _build_img2img_multipart(
336
+ prompt=prompt, model=model, steps=steps, seed=seed,
337
+ image=image, images=images, negative_prompt=negative_prompt,
338
+ loras=loras, width=width, height=height, guidance=guidance,
339
+ quality=quality, enhance_prompt=enhance_prompt,
340
+ webhook_url=webhook_url, webhook_secret=webhook_secret,
341
+ )
342
+ data = await afill_payload(self._client, data, IMAGE_KEYS, seed=True, form=True)
343
+ resp = await self._client.post(url, data=data, files=files)
344
+ request_id = resp["data"]["request_id"]
345
+ status_url = self._client._resolve_endpoint("request_status")
346
+ return AsyncJob(request_id, self._client, status_url)
347
+
348
+ async def transform_price(
349
+ self,
350
+ *,
351
+ prompt: str,
352
+ model: str,
353
+ steps: int | None = None,
354
+ seed: int | None = None,
355
+ image: FileInput | None = None,
356
+ images: list[FileInput] | None = None,
357
+ negative_prompt: str | None = None,
358
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
359
+ width: int | None = None,
360
+ height: int | None = None,
361
+ guidance: float | None = None,
362
+ quality: str | None = None,
363
+ ) -> PriceResult:
364
+ """Calculate price for an image edit.
365
+
366
+ Some models price by the input size, so pass the same ``image``/``images`` the job
367
+ will use. Without a source image the quote is sent as JSON.
368
+
369
+ Unset ``width``, ``height`` and ``steps`` are taken from the model's
370
+ ``info.defaults`` (one catalogue request per
371
+ client, cached; disable with ``fill_model_defaults=False``); ``seed`` defaults to -1 (random).
372
+ """
373
+ url = self._client._resolve_endpoint("img2img_price")
374
+ json_body, data, files = _build_img2img_price_request(
375
+ prompt=prompt, model=model, steps=steps, seed=seed, image=image, images=images,
376
+ negative_prompt=negative_prompt, loras=loras, width=width, height=height,
377
+ guidance=guidance, quality=quality,
378
+ )
379
+ payload = json_body if json_body is not None else data
380
+ assert payload is not None # one of json_body / data is always set
381
+ await afill_payload(self._client, payload, IMAGE_KEYS, seed=True, form=json_body is None)
382
+ resp = await self._client.post(url, json=json_body, data=data, files=files)
383
+ return PriceResult.model_validate(resp.get("data", resp))
384
+
385
+ async def upscale(
386
+ self,
387
+ *,
388
+ image: FileInput,
389
+ model: str,
390
+ webhook_url: str | None = None,
391
+ webhook_secret: str | None = None,
392
+ ) -> AsyncJob:
393
+ """Submit an image upscale job."""
394
+ url = self._client._resolve_endpoint("img_upscale")
395
+ data = {"model": model, **webhook_fields(webhook_url, webhook_secret)}
396
+ files = [("image", normalize_file(image, "image"))]
397
+ resp = await self._client.post(url, data=data, files=files)
398
+ request_id = resp["data"]["request_id"]
399
+ status_url = self._client._resolve_endpoint("request_status")
400
+ return AsyncJob(request_id, self._client, status_url)
401
+
402
+ async def upscale_price(
403
+ self,
404
+ *,
405
+ model: str,
406
+ image: FileInput | None = None,
407
+ width: int | None = None,
408
+ height: int | None = None,
409
+ ) -> PriceResult:
410
+ """Calculate price for image upscale (pass the image, or its width and height)."""
411
+ url = self._client._resolve_endpoint("img_upscale_price")
412
+ json_body, data, files = _build_size_price_request(model, image, width, height)
413
+ resp = await self._client.post(url, json=json_body, data=data, files=files)
414
+ return PriceResult.model_validate(resp.get("data", resp))
415
+
416
+ async def remove_background(
417
+ self,
418
+ *,
419
+ image: FileInput,
420
+ model: str,
421
+ webhook_url: str | None = None,
422
+ webhook_secret: str | None = None,
423
+ ) -> AsyncJob:
424
+ """Submit an image background removal job."""
425
+ url = self._client._resolve_endpoint("img_rmbg")
426
+ data = {"model": model, **webhook_fields(webhook_url, webhook_secret)}
427
+ files = [("image", normalize_file(image, "image"))]
428
+ resp = await self._client.post(url, data=data, files=files)
429
+ request_id = resp["data"]["request_id"]
430
+ status_url = self._client._resolve_endpoint("request_status")
431
+ return AsyncJob(request_id, self._client, status_url)
432
+
433
+ async def remove_background_price(
434
+ self,
435
+ *,
436
+ model: str,
437
+ image: FileInput | None = None,
438
+ width: int | None = None,
439
+ height: int | None = None,
440
+ ) -> PriceResult:
441
+ """Calculate price for image background removal (pass the image, or its width and height)."""
442
+ url = self._client._resolve_endpoint("img_rmbg_price")
443
+ json_body, data, files = _build_size_price_request(model, image, width, height)
444
+ resp = await self._client.post(url, json=json_body, data=data, files=files)
445
+ return PriceResult.model_validate(resp.get("data", resp))
446
+
447
+
448
+ # --- Private helpers ---
449
+
450
+ _Files = list[tuple[str, tuple[str, bytes, str]]]
451
+
452
+
453
+ def _serialize_loras(
454
+ loras: list[LoraWeight | dict[str, Any]],
455
+ ) -> list[dict[str, Any]]:
456
+ return [
457
+ lora.model_dump() if isinstance(lora, LoraWeight) else lora
458
+ for lora in loras
459
+ ]
460
+
461
+
462
+ def _build_txt2img_payload(
463
+ *,
464
+ prompt: str,
465
+ model: str,
466
+ width: int | None = None,
467
+ height: int | None = None,
468
+ seed: int | None = None,
469
+ negative_prompt: str | None = None,
470
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
471
+ guidance: float | None = None,
472
+ steps: int | None = None,
473
+ quality: str | None = None,
474
+ enhance_prompt: bool | None = None,
475
+ webhook_url: str | None = None,
476
+ webhook_secret: str | None = None,
477
+ ) -> dict[str, Any]:
478
+ payload = drop_none({
479
+ "prompt": prompt,
480
+ "model": model,
481
+ "width": width,
482
+ "height": height,
483
+ "seed": seed,
484
+ "negative_prompt": negative_prompt,
485
+ "guidance": guidance,
486
+ "steps": steps,
487
+ "quality": quality,
488
+ "enhance_prompt": enhance_prompt,
489
+ })
490
+ if loras is not None:
491
+ payload["loras"] = _serialize_loras(loras)
492
+ payload.update(webhook_fields(webhook_url, webhook_secret))
493
+ return payload
494
+
495
+
496
+ def _check_image_args(image: FileInput | None, images: list[FileInput] | None) -> None:
497
+ if image is not None and images is not None:
498
+ raise ValueError("Provide either 'image' or 'images', not both.")
499
+
500
+
501
+ def _img2img_fields(
502
+ *,
503
+ prompt: str,
504
+ model: str,
505
+ steps: int | None,
506
+ seed: int | None,
507
+ negative_prompt: str | None,
508
+ loras: list[LoraWeight | dict[str, Any]] | None,
509
+ width: int | None,
510
+ height: int | None,
511
+ guidance: float | None,
512
+ quality: str | None,
513
+ ) -> dict[str, Any]:
514
+ """Multipart text fields shared by edits and edits/price (loras as bracketed keys)."""
515
+ data = drop_none({
516
+ "prompt": prompt,
517
+ "model": model,
518
+ "steps": steps,
519
+ "seed": seed,
520
+ "negative_prompt": negative_prompt,
521
+ "width": width,
522
+ "height": height,
523
+ "guidance": guidance,
524
+ "quality": quality,
525
+ })
526
+ if loras is not None:
527
+ for i, lora in enumerate(_serialize_loras(loras)):
528
+ data[f"loras[{i}][name]"] = lora["name"]
529
+ data[f"loras[{i}][weight]"] = lora["weight"]
530
+ return data
531
+
532
+
533
+ def _img2img_files(image: FileInput | None, images: list[FileInput] | None) -> _Files:
534
+ file_tuples: _Files = []
535
+ if image is not None:
536
+ file_tuples.append(("image", normalize_file(image, "image")))
537
+ elif images is not None:
538
+ for f in normalize_files(images, "image"):
539
+ file_tuples.append(("images[]", f))
540
+ return file_tuples
541
+
542
+
543
+ def _build_img2img_multipart(
544
+ *,
545
+ prompt: str,
546
+ model: str,
547
+ steps: int | None = None,
548
+ seed: int | None = None,
549
+ image: FileInput | None = None,
550
+ images: list[FileInput] | None = None,
551
+ negative_prompt: str | None = None,
552
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
553
+ width: int | None = None,
554
+ height: int | None = None,
555
+ guidance: float | None = None,
556
+ quality: str | None = None,
557
+ enhance_prompt: bool | None = None,
558
+ webhook_url: str | None = None,
559
+ webhook_secret: str | None = None,
560
+ ) -> tuple[dict[str, Any], _Files]:
561
+ """Build multipart form data and files list for img2img."""
562
+ _check_image_args(image, images)
563
+ if image is None and images is None:
564
+ raise ValueError("Either 'image' or 'images' is required.")
565
+ webhook = webhook_fields(webhook_url, webhook_secret)
566
+
567
+ data = _img2img_fields(
568
+ prompt=prompt, model=model, steps=steps, seed=seed, negative_prompt=negative_prompt,
569
+ loras=loras, width=width, height=height, guidance=guidance, quality=quality,
570
+ )
571
+ if enhance_prompt is not None:
572
+ data["enhance_prompt"] = form_bool(enhance_prompt)
573
+ data.update(webhook)
574
+ return data, _img2img_files(image, images)
575
+
576
+
577
+ def _build_img2img_price_request(
578
+ *,
579
+ prompt: str,
580
+ model: str,
581
+ steps: int | None = None,
582
+ seed: int | None = None,
583
+ image: FileInput | None = None,
584
+ images: list[FileInput] | None = None,
585
+ negative_prompt: str | None = None,
586
+ loras: list[LoraWeight | dict[str, Any]] | None = None,
587
+ width: int | None = None,
588
+ height: int | None = None,
589
+ guidance: float | None = None,
590
+ quality: str | None = None,
591
+ ) -> tuple[dict[str, Any] | None, dict[str, Any] | None, _Files | None]:
592
+ """Return (json, data, files) for edits/price: multipart when a source image is given."""
593
+ _check_image_args(image, images)
594
+ if image is None and images is None:
595
+ payload = drop_none({
596
+ "prompt": prompt, "model": model, "steps": steps, "seed": seed,
597
+ "negative_prompt": negative_prompt, "width": width, "height": height,
598
+ "guidance": guidance, "quality": quality,
599
+ })
600
+ if loras is not None:
601
+ payload["loras"] = _serialize_loras(loras)
602
+ return payload, None, None
603
+ data = _img2img_fields(
604
+ prompt=prompt, model=model, steps=steps, seed=seed, negative_prompt=negative_prompt,
605
+ loras=loras, width=width, height=height, guidance=guidance, quality=quality,
606
+ )
607
+ return None, data, _img2img_files(image, images)
608
+
609
+
610
+ def _build_size_price_request(
611
+ model: str, image: FileInput | None, width: int | None, height: int | None
612
+ ) -> tuple[dict[str, Any] | None, dict[str, Any] | None, _Files | None]:
613
+ """Return (json, data, files) for size-priced quotes: the image itself, or width/height."""
614
+ if image is not None:
615
+ return None, {"model": model}, [("image", normalize_file(image, "image"))]
616
+ return drop_none({"model": model, "width": width, "height": height}), None, None