ads_dev 1.0.0__py3-none-any.whl

ads_dev/types.py

@@ -0,0 +1,2126 @@
+# generated by datamodel-codegen:
+#   filename:  openapi.json
+
+from __future__ import annotations
+
+from typing import Any, Literal
+from uuid import UUID
+
+from pydantic import (
+    AnyUrl,
+    BaseModel,
+    ConfigDict,
+    Field,
+    RootModel,
+    confloat,
+    conint,
+    constr,
+)
+
+
+class CreateNanoBananaProInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="What the image shows, as one paragraph; 150 to 350 words of concrete detail work best.",
+    )
+    aspect_ratio: (
+        Literal["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"]
+        | None
+    ) = Field("1:1", description="Shape of the image as width:height; 1:1 when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K", description="Output resolution; 2K when left out."
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateNanoBananaPro(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["nano-banana-pro"]
+    input: CreateNanoBananaProInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateNanoBananaProEditInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="The change to make, or how the images come together, naming each image by its place in images.",
+    )
+    aspect_ratio: (
+        Literal[
+            "auto",
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+        ]
+        | None
+    ) = Field("auto", description="Shape of the image as width:height, or auto to follow the images given; auto when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K", description="Output resolution; 2K when left out."
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    images: list[str] = Field(
+        ...,
+        description="The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL.",
+        max_length=14,
+        min_length=1,
+    )
+    seed: conint(ge=-9007199254740991, le=9007199254740991) | None = Field(
+        None,
+        description="Integer seed for a more repeatable edit; random when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateNanoBananaProEdit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["nano-banana-pro/edit"]
+    input: CreateNanoBananaProEditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateNanoBanana2Input(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="What the image shows, as one paragraph; 150 to 350 words of concrete detail work best.",
+    )
+    aspect_ratio: (
+        Literal[
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+            "4:1",
+            "1:4",
+            "8:1",
+            "1:8",
+        ]
+        | None
+    ) = Field("1:1", description="Shape of the image as width:height; 1:1 when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K", description="Output resolution; 2K when left out."
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateNanoBanana2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["nano-banana-2"]
+    input: CreateNanoBanana2Input
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateNanoBanana2EditInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="The change to make, or how the images come together, naming each image by its place in images.",
+    )
+    aspect_ratio: (
+        Literal[
+            "auto",
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+            "4:1",
+            "1:4",
+            "8:1",
+            "1:8",
+        ]
+        | None
+    ) = Field("auto", description="Shape of the image as width:height, or auto to follow the images given; auto when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K", description="Output resolution; 2K when left out."
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    images: list[str] = Field(
+        ...,
+        description="The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL.",
+        max_length=14,
+        min_length=1,
+    )
+    seed: conint(ge=-9007199254740991, le=9007199254740991) | None = Field(
+        None,
+        description="Integer seed for a more repeatable edit; random when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateNanoBanana2Edit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["nano-banana-2/edit"]
+    input: CreateNanoBanana2EditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateNanoBanana2LiteInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="What the image shows, as one paragraph; 150 to 350 words of concrete detail work best.",
+    )
+    aspect_ratio: (
+        Literal[
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+            "4:1",
+            "1:4",
+            "8:1",
+            "1:8",
+        ]
+        | None
+    ) = Field("1:1", description="Shape of the image as width:height; 1:1 when left out.")
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateNanoBanana2Lite(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["nano-banana-2-lite"]
+    input: CreateNanoBanana2LiteInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateNanoBanana2LiteEditInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="The change to make, or how the images come together, naming each image by its place in images.",
+    )
+    aspect_ratio: (
+        Literal[
+            "auto",
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+            "4:1",
+            "1:4",
+            "8:1",
+            "1:8",
+        ]
+        | None
+    ) = Field("auto", description="Shape of the image as width:height, or auto to follow the images given; auto when left out.")
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    images: list[str] = Field(
+        ...,
+        description="The 1 to 14 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL.",
+        max_length=14,
+        min_length=1,
+    )
+    seed: conint(ge=-9007199254740991, le=9007199254740991) | None = Field(
+        None,
+        description="Integer seed for a more repeatable edit; random when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateNanoBanana2LiteEdit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["nano-banana-2-lite/edit"]
+    input: CreateNanoBanana2LiteEditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGptImage25FlareInput(BaseModel):
+    prompt: constr(min_length=1, max_length=32000) = Field(
+        ...,
+        description="Single-paragraph image prompt (150-350 words), with any words the image must show written out exactly.",
+    )
+    aspect_ratio: (
+        Literal["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"]
+        | None
+    ) = Field("1:1", description="Shape of the image as width:height; 1:1 when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K", description="Output resolution; 2K when left out."
+    )
+    width: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact width in pixels for a fixed placement, passed with height in place of aspect_ratio and resolution, with both sides multiples of 16 up to 3840, at most 3:1 either way, and 655,360 to 8,294,400 pixels in all; none when left out.",
+    )
+    height: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact height in pixels, passed with width under the same rules; none when left out.",
+    )
+    background: Literal["auto", "transparent", "opaque"] | None = Field(
+        "auto",
+        description="transparent for a cutout with no background, opaque for a filled one, or auto to let the model choose; auto when left out.",
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png",
+        description="File format; png when left out, and a transparent background needs png or webp.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGptImage25Flare(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gpt-image-2.5-flare"]
+    input: CreateGptImage25FlareInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGptImage25FlareEditInput(BaseModel):
+    prompt: constr(min_length=1, max_length=32000) = Field(
+        ...,
+        description="The change to make, or how the images come together, naming each image by its place in images and writing out exactly any words the image must show.",
+    )
+    aspect_ratio: (
+        Literal[
+            "auto",
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+        ]
+        | None
+    ) = Field("auto", description="Shape of the image as width:height, or auto to let the model pick the size; auto when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K",
+        description="Output resolution, not used when aspect_ratio is auto; 2K when left out.",
+    )
+    width: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact width in pixels for a fixed placement, passed with height in place of aspect_ratio and resolution, with both sides multiples of 16 up to 3840, at most 3:1 either way, and 655,360 to 8,294,400 pixels in all; none when left out.",
+    )
+    height: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact height in pixels, passed with width under the same rules; none when left out.",
+    )
+    background: Literal["auto", "transparent", "opaque"] | None = Field(
+        "auto",
+        description="transparent for a cutout with no background, opaque for a filled one, or auto to let the model choose; auto when left out.",
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png",
+        description="File format; png when left out, and a transparent background needs png or webp.",
+    )
+    images: list[str] = Field(
+        ...,
+        description="The 1 to 16 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL.",
+        max_length=16,
+        min_length=1,
+    )
+    mask: str | None = Field(
+        None,
+        description="An image the size of the first of images, as an asset id (asset_…) or an https URL, with an alpha channel that is fully transparent where that image should change; the model takes it as guidance, so the rest can shift slightly. None when left out, so the prompt alone scopes the change.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGptImage25FlareEdit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gpt-image-2.5-flare/edit"]
+    input: CreateGptImage25FlareEditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGptImage25SunburstInput(BaseModel):
+    prompt: constr(min_length=1, max_length=32000) = Field(
+        ...,
+        description="Single-paragraph image prompt (150-350 words), with any words the image must show written out exactly.",
+    )
+    aspect_ratio: (
+        Literal["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"]
+        | None
+    ) = Field("1:1", description="Shape of the image as width:height; 1:1 when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K", description="Output resolution; 2K when left out."
+    )
+    width: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact width in pixels for a fixed placement, passed with height in place of aspect_ratio and resolution, with both sides multiples of 16 up to 3840, at most 3:1 either way, and 655,360 to 8,294,400 pixels in all; none when left out.",
+    )
+    height: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact height in pixels, passed with width under the same rules; none when left out.",
+    )
+    background: Literal["auto", "transparent", "opaque"] | None = Field(
+        "auto",
+        description="transparent for a cutout with no background, opaque for a filled one, or auto to let the model choose; auto when left out.",
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png",
+        description="File format; png when left out, and a transparent background needs png or webp.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGptImage25Sunburst(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gpt-image-2.5-sunburst"]
+    input: CreateGptImage25SunburstInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGptImage25SunburstEditInput(BaseModel):
+    prompt: constr(min_length=1, max_length=32000) = Field(
+        ...,
+        description="The change to make, or how the images come together, naming each image by its place in images and writing out exactly any words the image must show.",
+    )
+    aspect_ratio: (
+        Literal[
+            "auto",
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+        ]
+        | None
+    ) = Field("auto", description="Shape of the image as width:height, or auto to let the model pick the size; auto when left out.")
+    resolution: Literal["1K", "2K", "4K"] | None = Field(
+        "2K",
+        description="Output resolution, not used when aspect_ratio is auto; 2K when left out.",
+    )
+    width: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact width in pixels for a fixed placement, passed with height in place of aspect_ratio and resolution, with both sides multiples of 16 up to 3840, at most 3:1 either way, and 655,360 to 8,294,400 pixels in all; none when left out.",
+    )
+    height: conint(le=9007199254740991, gt=0) | None = Field(
+        None,
+        description="Exact height in pixels, passed with width under the same rules; none when left out.",
+    )
+    background: Literal["auto", "transparent", "opaque"] | None = Field(
+        "auto",
+        description="transparent for a cutout with no background, opaque for a filled one, or auto to let the model choose; auto when left out.",
+    )
+    output_format: Literal["png", "jpeg", "webp"] | None = Field(
+        "png",
+        description="File format; png when left out, and a transparent background needs png or webp.",
+    )
+    images: list[str] = Field(
+        ...,
+        description="The 1 to 16 images to edit or combine, in the order the prompt names them, each an asset id (asset_…) or an https URL.",
+        max_length=16,
+        min_length=1,
+    )
+    mask: str | None = Field(
+        None,
+        description="An image the size of the first of images, as an asset id (asset_…) or an https URL, with an alpha channel that is fully transparent where that image should change; the model takes it as guidance, so the rest can shift slightly. None when left out, so the prompt alone scopes the change.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGptImage25SunburstEdit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gpt-image-2.5-sunburst/edit"]
+    input: CreateGptImage25SunburstEditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedream5ProInput(BaseModel):
+    prompt: constr(min_length=3) = Field(
+        ...,
+        description="Single-paragraph image prompt, at most 600 words, with the exact words the image must show written out.",
+    )
+    aspect_ratio: (
+        Literal["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"]
+        | None
+    ) = Field("1:1", description="Shape of the image as width:height; 1:1 when left out.")
+    resolution: Literal["1.5K", "2K"] | None = Field(
+        "2K",
+        description="Output resolution, 1.5K for drafts at half the price and 2K for finals; 2K when left out.",
+    )
+    output_format: Literal["png", "jpeg"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedream5Pro(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedream-5-pro"]
+    input: CreateSeedream5ProInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedream5ProEditInput(BaseModel):
+    prompt: constr(min_length=3) = Field(
+        ...,
+        description="The change to make as one paragraph, at most 600 words, naming each image by its place in images (image 1, image 2), with the exact words the result must show written out.",
+    )
+    aspect_ratio: (
+        Literal[
+            "auto",
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+        ]
+        | None
+    ) = Field("auto", description="Shape of the result as width:height, or auto to keep the shape the images suggest; auto when left out.")
+    resolution: Literal["1.5K", "2K"] | None = Field(
+        "2K",
+        description="Output resolution, 1.5K for drafts at half the price and 2K for finals; 2K when left out.",
+    )
+    output_format: Literal["png", "jpeg"] | None = Field(
+        "png", description="File format; png when left out."
+    )
+    images: list[str] = Field(
+        ...,
+        description="The images to edit or combine, in the order the prompt names them, at most 10, each an asset id (asset_…) or an https URL.",
+        max_length=10,
+        min_length=1,
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedream5ProEdit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedream-5-pro/edit"]
+    input: CreateSeedream5ProEditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedream5LiteInput(BaseModel):
+    prompt: constr(min_length=3) = Field(
+        ...,
+        description="Single-paragraph image prompt, at most 600 words, with the exact words the image must show written out.",
+    )
+    aspect_ratio: (
+        Literal["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"]
+        | None
+    ) = Field("1:1", description="Shape of the image as width:height; 1:1 when left out.")
+    resolution: Literal["2K", "3K", "4K"] | None = Field(
+        "2K",
+        description="Output resolution, 2K, 3K or 4K, all at one price; 2K when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedream5Lite(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedream-5-lite"]
+    input: CreateSeedream5LiteInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedream5LiteEditInput(BaseModel):
+    prompt: constr(min_length=3) = Field(
+        ...,
+        description="The change to make as one paragraph, at most 600 words, naming each image by its place in images (image 1, image 2), with the exact words the result must show written out.",
+    )
+    aspect_ratio: (
+        Literal[
+            "auto",
+            "1:1",
+            "21:9",
+            "16:9",
+            "3:2",
+            "4:3",
+            "5:4",
+            "4:5",
+            "3:4",
+            "2:3",
+            "9:16",
+        ]
+        | None
+    ) = Field("auto", description="Shape of the result as width:height, or auto to keep the shape the images suggest; auto when left out.")
+    resolution: Literal["2K", "3K", "4K"] | None = Field(
+        "2K",
+        description="Output resolution, 2K, 3K or 4K, all at one price; 2K when left out.",
+    )
+    images: list[str] = Field(
+        ...,
+        description="The images to edit or combine, in the order the prompt names them, at most 14, each an asset id (asset_…) or an https URL.",
+        max_length=14,
+        min_length=1,
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedream5LiteEdit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedream-5-lite/edit"]
+    input: CreateSeedream5LiteEditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedream5ProLayersInput(BaseModel):
+    image: str = Field(
+        ...,
+        description="The image to split into layers, as an asset id (asset_…) or an https URL.",
+    )
+    prompt: constr(min_length=3) | None = Field(
+        "Return name and description in english.",
+        description="One sentence on how to split, group or name the layers; asks for English names and descriptions when left out.",
+    )
+    resolution: Literal["1.5K", "2K"] | None = Field(
+        "2K",
+        description="Resolution of the layers, 1.5K for drafts and 2K for finals; 2K when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedream5ProLayers(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedream-5-pro/layers"]
+    input: CreateSeedream5ProLayersInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateTopazUpscaleInput(BaseModel):
+    image: str = Field(
+        ...,
+        description="The image to enlarge, as an asset id (asset_…) or an https URL.",
+    )
+    upscale_factor: confloat(ge=1.0, le=4.0) | None = Field(
+        2,
+        description="How many times wider and taller the image comes out, from 1 to 4, so 2 makes four times the pixels; 2 when left out.",
+    )
+    preset: (
+        Literal["standard", "high_fidelity", "low_resolution", "cgi", "text"] | None
+    ) = Field("standard", description="standard suits most photos, high_fidelity keeps the fine detail of a professional shot, low_resolution recovers a small or compressed source, cgi suits renders and illustrations, and text keeps lettering and shapes crisp; standard when left out.")
+    face_enhancement: bool | None = Field(
+        True,
+        description="Whether faces get their detail recovered; true when left out, and false for a shot with no people in it.",
+    )
+    output_format: Literal["jpeg", "png"] | None = Field(
+        "jpeg",
+        description="jpeg is the smaller file and png keeps every pixel; jpeg when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateTopazUpscale(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["topaz/upscale"]
+    input: CreateTopazUpscaleInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedance25TextToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ..., description="What happens in the clip."
+    )
+    aspect_ratio: (
+        Literal["auto", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"] | None
+    ) = Field("auto", description="Shape of the clip as width:height, or auto to let the model decide; auto when left out.")
+    draft: bool | None = Field(
+        False,
+        description="Whether to make a cheap 480p draft, whatever resolution says, that seedance-2.5/finish can finish at 1080p within 7 days; false when left out.",
+    )
+    duration: Literal["auto"] | conint(ge=4, le=30) | None = Field(
+        "auto",
+        description="Length in whole seconds from 4 to 30, or auto to let the model decide; auto when left out.",
+    )
+    resolution: Literal["480p", "720p", "1080p"] | None = Field(
+        "720p", description="Output resolution; 720p when left out."
+    )
+    generate_audio: bool | None = Field(
+        True,
+        description="Whether the clip gets sound, speech and music made for it; true when left out.",
+    )
+    codec: Literal["auto", "H264", "H265"] | None = Field(
+        "auto", description="Video codec; auto when left out."
+    )
+    bitrate_mode: Literal["standard", "high"] | None = Field(
+        "standard",
+        description="high asks for a larger, higher quality file; standard when left out.",
+    )
+    output_format: Literal["mp4", "mov"] | None = Field(
+        "mp4",
+        description="mp4 plays anywhere, mov keeps more color for grading; mp4 when left out.",
+    )
+    return_last_frame: bool | None = Field(
+        False,
+        description="Whether the last frame is also saved as an image, to start the next clip from; false when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedance25TextToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedance-2.5/text-to-video"]
+    input: CreateSeedance25TextToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedance25ImageToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="What happens in the clip, from the start image to the end image when one is given.",
+    )
+    start_image: str = Field(
+        ...,
+        description="The image the clip opens on, as an asset id (asset_…) or an https URL; the clip takes its shape.",
+    )
+    end_image: str | None = Field(
+        None,
+        description="The image the clip ends on, as an asset id (asset_…) or an https URL; none when left out, so the model picks the ending.",
+    )
+    draft: bool | None = Field(
+        False,
+        description="Whether to make a cheap 480p draft, whatever resolution says, that seedance-2.5/finish can finish at 1080p within 7 days; false when left out.",
+    )
+    duration: Literal["auto"] | conint(ge=4, le=30) | None = Field(
+        "auto",
+        description="Length in whole seconds from 4 to 30, or auto to let the model decide; auto when left out.",
+    )
+    resolution: Literal["480p", "720p", "1080p"] | None = Field(
+        "720p", description="Output resolution; 720p when left out."
+    )
+    generate_audio: bool | None = Field(
+        True,
+        description="Whether the clip gets sound, speech and music made for it; true when left out.",
+    )
+    codec: Literal["auto", "H264", "H265"] | None = Field(
+        "auto", description="Video codec; auto when left out."
+    )
+    bitrate_mode: Literal["standard", "high"] | None = Field(
+        "standard",
+        description="high asks for a larger, higher quality file; standard when left out.",
+    )
+    output_format: Literal["mp4", "mov"] | None = Field(
+        "mp4",
+        description="mp4 plays anywhere, mov keeps more color for grading; mp4 when left out.",
+    )
+    return_last_frame: bool | None = Field(
+        False,
+        description="Whether the last frame is also saved as an image, to start the next clip from; false when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedance25ImageToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedance-2.5/image-to-video"]
+    input: CreateSeedance25ImageToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedance25ReferenceToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=50000) = Field(
+        ...,
+        description="What happens in the clip, citing each image, video or audio by its place in its list as @Image1, @Video1 or @Audio1.",
+    )
+    task: Literal["auto", "reference", "editing", "extension"] | None = Field(
+        "auto",
+        description="reference makes a new clip from the references, editing changes the first of videos, extension continues it; auto when left out, which lets the model decide.",
+    )
+    images: list[str] | None = Field(
+        [],
+        description="Up to 30 images, each an asset id (asset_…) or an https URL; none when left out.",
+        max_length=30,
+    )
+    videos: list[str] | None = Field(
+        [],
+        description="Up to 10 videos, 30 seconds together at most, each an asset id (asset_…) or an https URL; none when left out.",
+        max_length=10,
+    )
+    audio: list[str] | None = Field(
+        [],
+        description="Up to 10 wav or mp3 files, 30 seconds together at most, each an asset id (asset_…) or an https URL; none when left out.",
+        max_length=10,
+    )
+    aspect_ratio: (
+        Literal["auto", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"] | None
+    ) = Field("auto", description="Shape of the clip as width:height, or auto to follow the references; auto when left out.")
+    seed: conint(ge=-9007199254740991, le=9007199254740991) | None = Field(
+        None,
+        description="Integer seed for a more repeatable take; random when left out.",
+    )
+    draft: bool | None = Field(
+        False,
+        description="Whether to make a cheap 480p draft, whatever resolution says, that seedance-2.5/finish can finish at 1080p within 7 days; false when left out.",
+    )
+    duration: Literal["auto"] | conint(ge=4, le=30) | None = Field(
+        "auto",
+        description="Length in whole seconds from 4 to 30, or auto to let the model decide; auto when left out.",
+    )
+    resolution: Literal["480p", "720p", "1080p"] | None = Field(
+        "720p", description="Output resolution; 720p when left out."
+    )
+    generate_audio: bool | None = Field(
+        True,
+        description="Whether the clip gets sound, speech and music made for it; true when left out.",
+    )
+    codec: Literal["auto", "H264", "H265"] | None = Field(
+        "auto", description="Video codec; auto when left out."
+    )
+    bitrate_mode: Literal["standard", "high"] | None = Field(
+        "standard",
+        description="high asks for a larger, higher quality file; standard when left out.",
+    )
+    output_format: Literal["mp4", "mov"] | None = Field(
+        "mp4",
+        description="mp4 plays anywhere, mov keeps more color for grading; mp4 when left out.",
+    )
+    return_last_frame: bool | None = Field(
+        False,
+        description="Whether the last frame is also saved as an image, to start the next clip from; false when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedance25ReferenceToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedance-2.5/reference-to-video"]
+    input: CreateSeedance25ReferenceToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSeedance25FinishInput(BaseModel):
+    draft: constr(max_length=42) = Field(
+        ...,
+        description="The draft to finish: the asset id of a Seedance 2.5 clip made with draft set to true.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSeedance25Finish(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["seedance-2.5/finish"]
+    input: CreateSeedance25FinishInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateKling3ProImageToVideoInputMultiPromptItem(BaseModel):
+    prompt: constr(min_length=3, max_length=2500) = Field(
+        ..., description="What happens in this shot."
+    )
+    duration: conint(ge=1, le=15) | None = Field(
+        5,
+        description="Length of this shot in whole seconds from 1 to 15; 5 when left out.",
+    )
+
+
+class CreateKling3ProImageToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=2500) | None = Field(
+        None,
+        description="What happens in the clip, up to 2500 characters; leave it out when multi_prompt gives the shots instead.",
+    )
+    multi_prompt: list[CreateKling3ProImageToVideoInputMultiPromptItem] | None = Field(
+        None,
+        description="Shots cut end to end in one clip, in order, which together run 3 to 15 seconds; in place of prompt and duration, and none when left out.",
+        min_length=1,
+    )
+    start_image: str = Field(
+        ...,
+        description="The image the clip opens on, as an asset id (asset_…) or an https URL.",
+    )
+    end_image: str | None = Field(
+        None,
+        description="The image the clip ends on, as an asset id (asset_…) or an https URL; none when left out, so the model picks the ending.",
+    )
+    negative_prompt: constr(min_length=1, max_length=2500) | None = Field(
+        None,
+        description='What the clip must not show, such as "lens flare, morphing faces"; Kling\'s own "blur, distort, and low quality" when left out.',
+    )
+    cfg_scale: confloat(ge=0.0, le=1.0) | None = Field(
+        0.5,
+        description="How closely the clip keeps to the prompt, from 0 to 1; 0.5 when left out.",
+    )
+    duration: conint(ge=3, le=15) | None = Field(
+        None,
+        description="Length in whole seconds from 3 to 15; 5 when left out, and left out with multi_prompt, whose shot lengths add up to the clip's.",
+    )
+    generate_audio: bool | None = Field(
+        True,
+        description="Whether the clip gets sound and speech made for it; true when left out.",
+    )
+    shot_type: Literal["customize", "intelligent"] | None = Field(
+        "customize",
+        description="customize cuts multi_prompt shots as written, intelligent lets Kling decide the shot structure; customize when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateKling3ProImageToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["kling-3-pro/image-to-video"]
+    input: CreateKling3ProImageToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateKlingO3ProReferenceToVideoInputMultiPromptItem(BaseModel):
+    prompt: constr(min_length=3, max_length=2500) = Field(
+        ..., description="What happens in this shot."
+    )
+    duration: conint(ge=1, le=15) | None = Field(
+        5,
+        description="Length of this shot in whole seconds from 1 to 15; 5 when left out.",
+    )
+
+
+class CreateKlingO3ProReferenceToVideoInputElements(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    frontal_image: str = Field(
+        ...,
+        description="A front view of the character or object, as an asset id (asset_…) or an https URL.",
+    )
+    reference_images: list[str] = Field(
+        ...,
+        description="1 to 3 more views of the same character or object, from other angles, each an asset id (asset_…) or an https URL.",
+        max_length=3,
+        min_length=1,
+    )
+
+
+class CreateKlingO3ProReferenceToVideoInputElements1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    video: str = Field(
+        ...,
+        description="A clip of the character or object, 3 to 10 seconds at 720 to 2160 px a side, as an asset id (asset_…) or an https URL, in place of images.",
+    )
+
+
+class CreateKlingO3ProReferenceToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=2500) | None = Field(
+        None,
+        description="What happens in the clip, up to 2500 characters; leave it out when multi_prompt gives the shots instead.",
+    )
+    multi_prompt: list[CreateKlingO3ProReferenceToVideoInputMultiPromptItem] | None = (
+        Field(
+            None,
+            description="Shots cut end to end in one clip, in order, which together run 3 to 15 seconds; in place of prompt and duration, and none when left out.",
+            min_length=1,
+        )
+    )
+    start_image: str | None = Field(
+        None,
+        description="The image the clip opens on, as an asset id (asset_…) or an https URL; none when left out, so the model composes the opening from the prompt and the references.",
+    )
+    end_image: str | None = Field(
+        None,
+        description="The image the clip ends on, as an asset id (asset_…) or an https URL; none when left out, so the model picks the ending.",
+    )
+    images: list[str] | None = Field(
+        [],
+        description="Up to 4 images whose subject or look the clip keeps, each an asset id (asset_…) or an https URL, cited in the prompt as @Image1, @Image2 in this order; none when left out.",
+        max_length=4,
+    )
+    elements: (
+        list[
+            CreateKlingO3ProReferenceToVideoInputElements | CreateKlingO3ProReferenceToVideoInputElements1
+        ]
+        | None
+    ) = Field([], description="Characters or objects held to one look across the clip, cited in the prompt as @Element1, @Element2 in this order; images and elements take 4 together at most, and none when left out.", max_length=4, validate_default=True)
+    aspect_ratio: Literal["16:9", "9:16", "1:1"] | None = Field(
+        "16:9", description="Shape of the clip as width:height; 16:9 when left out."
+    )
+    duration: conint(ge=3, le=15) | None = Field(
+        None,
+        description="Length in whole seconds from 3 to 15; 5 when left out, and left out with multi_prompt, whose shot lengths add up to the clip's.",
+    )
+    generate_audio: bool | None = Field(
+        True,
+        description="Whether the clip gets sound and speech made for it; true when left out.",
+    )
+    shot_type: Literal["customize", "intelligent"] | None = Field(
+        "customize",
+        description="customize cuts multi_prompt shots as written, intelligent lets Kling decide the shot structure; customize when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateKlingO3ProReferenceToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["kling-o3-pro/reference-to-video"]
+    input: CreateKlingO3ProReferenceToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGeminiOmniFlashTextToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=20000) = Field(
+        ...,
+        description="What happens in the clip, with any spoken line in double quotes.",
+    )
+    aspect_ratio: Literal["9:16", "16:9"] | None = Field(
+        "9:16",
+        description="Shape of the clip, portrait 9:16 or landscape 16:9; 9:16 when left out.",
+    )
+    duration: conint(ge=3, le=10) | None = Field(
+        8, description="Length in whole seconds from 3 to 10; 8 when left out."
+    )
+    resolution: Literal["360p", "720p", "1080p", "4k"] | None = Field(
+        "720p",
+        description="Output resolution, 360p for a cheap draft up to 4k, and the price per second rises with it; 720p when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGeminiOmniFlashTextToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gemini-omni-flash/text-to-video"]
+    input: CreateGeminiOmniFlashTextToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGeminiOmniFlashImageToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=20000) = Field(
+        ...,
+        description="How the image comes to life, up to the end image when one is given, with any spoken line in double quotes.",
+    )
+    start_image: str = Field(
+        ...,
+        description="The image the clip opens on, as an asset id (asset_…) or an https URL.",
+    )
+    end_image: str | None = Field(
+        None,
+        description="The image the clip ends on, as an asset id (asset_…) or an https URL; none when left out, so the model picks the ending.",
+    )
+    aspect_ratio: Literal["9:16", "16:9"] | None = Field(
+        "9:16",
+        description="Shape of the clip, portrait 9:16 or landscape 16:9; 9:16 when left out.",
+    )
+    duration: conint(ge=3, le=10) | None = Field(
+        8, description="Length in whole seconds from 3 to 10; 8 when left out."
+    )
+    resolution: Literal["360p", "720p", "1080p", "4k"] | None = Field(
+        "720p",
+        description="Output resolution, 360p for a cheap draft up to 4k, and the price per second rises with it; 720p when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGeminiOmniFlashImageToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gemini-omni-flash/image-to-video"]
+    input: CreateGeminiOmniFlashImageToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGeminiOmniFlashReferenceToVideoInput(BaseModel):
+    prompt: constr(min_length=3, max_length=20000) = Field(
+        ...,
+        description="What happens in the clip, citing each image or video inline by its place in its list from 0, as <IMAGE_REF_0> or <VIDEO_REF_0>, with any spoken line in double quotes.",
+    )
+    images: list[str] | None = Field(
+        [],
+        description="Up to 10 images of the faces, products or places to keep, each an asset id (asset_…) or an https URL; none when left out.",
+        max_length=10,
+    )
+    videos: list[str] | None = Field(
+        [],
+        description="Up to 3 videos, each shorter than 3 seconds, for a likeness or a motion to copy, whose sound is ignored, each an asset id (asset_…) or an https URL; none when left out.",
+        max_length=3,
+    )
+    aspect_ratio: Literal["9:16", "16:9"] | None = Field(
+        "9:16",
+        description="Shape of the clip, portrait 9:16 or landscape 16:9; 9:16 when left out.",
+    )
+    duration: conint(ge=3, le=10) | None = Field(
+        8, description="Length in whole seconds from 3 to 10; 8 when left out."
+    )
+    resolution: Literal["360p", "720p", "1080p", "4k"] | None = Field(
+        "720p",
+        description="Output resolution, 360p for a cheap draft up to 4k, and the price per second rises with it; 720p when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGeminiOmniFlashReferenceToVideo(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gemini-omni-flash/reference-to-video"]
+    input: CreateGeminiOmniFlashReferenceToVideoInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateGeminiOmniFlashEditInput(BaseModel):
+    prompt: constr(min_length=3, max_length=20000) = Field(
+        ...,
+        description='One simple change to make, ending with "Keep everything else the same." to hold the rest of the scene.',
+    )
+    video: str = Field(
+        ...,
+        description="The video to edit, 10 seconds or shorter, as an asset id (asset_…) or an https URL.",
+    )
+    resolution: Literal["360p", "720p", "1080p", "4k"] | None = Field(
+        None,
+        description="Output resolution; the source video's own when left out, so set it only to step the clip up or down.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateGeminiOmniFlashEdit(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["gemini-omni-flash/edit"]
+    input: CreateGeminiOmniFlashEditInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSync3LipsyncInput(BaseModel):
+    video: str = Field(
+        ...,
+        description="The video to re-sync, as an asset id (asset_…) or an https URL, showing one clear, front-facing speaker.",
+    )
+    audio: str = Field(
+        ...,
+        description="The speech the lips follow, as an asset id (asset_…) or an https URL: a new voiceover, a dub, or the clip's own track saved as audio.",
+    )
+    sync_mode: Literal["cut_off", "loop", "bounce", "silence", "remap"] | None = Field(
+        "cut_off",
+        description="What happens when the audio and the video differ in length: cut_off ends the clip at the shorter one, loop and bounce replay the video, from the start or forward then back, until the audio ends, silence keeps the longer one with silence after the audio, and remap retimes the video to the audio; cut_off when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSync3Lipsync(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["sync-3/lipsync"]
+    input: CreateSync3LipsyncInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateElevenlabsVoiceoverInput(BaseModel):
+    text: constr(min_length=1, max_length=5000) = Field(
+        ...,
+        description="The script to read aloud, up to 5000 characters, written as it should sound: inline audio tags in square brackets direct the delivery, such as [whispering], [laughs], [excited], [pause] or [door slams], and a word in IPA between slashes, such as /ˈnaɪki/, fixes its pronunciation.",
+    )
+    voice: constr(min_length=1, max_length=64) | None = Field(
+        "Jessica",
+        description="The voice that reads the script: a premade voice name, or a voice id from GET /v1/voices; Jessica when left out.",
+    )
+    stability: Literal["creative", "natural", "robust"] | None = Field(
+        "natural",
+        description="creative varies the delivery most and robust keeps it steadiest; natural when left out.",
+    )
+    similarity_boost: confloat(ge=0.0, le=1.0) | None = Field(
+        0.75,
+        description="How closely the speech holds to the voice, from 0 to 1; high values can carry the quirks of its source recording, and 0.75 when left out.",
+    )
+    language_code: constr(pattern=r"^[a-z]{2}$") | None = Field(
+        None,
+        description="The language to speak in, as a two-letter ISO 639-1 code such as en, pt or es; read from the script when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateElevenlabsVoiceover(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["elevenlabs/voiceover"]
+    input: CreateElevenlabsVoiceoverInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateElevenlabsMusicInput(BaseModel):
+    prompt: constr(min_length=3, max_length=4100) = Field(
+        ...,
+        description="The track: genre, mood, instruments, tempo, and any lyrics or vocal style, up to 4100 characters.",
+    )
+    duration: Literal["auto"] | conint(ge=3, le=600) | None = Field(
+        "auto",
+        description="Length in whole seconds from 3 to 600, or auto to let the model decide; auto when left out.",
+    )
+    force_instrumental: bool | None = Field(
+        False,
+        description="true guarantees a track with no vocals; false when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateElevenlabsMusic(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["elevenlabs/music"]
+    input: CreateElevenlabsMusicInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateElevenlabsSoundEffectsInput(BaseModel):
+    prompt: constr(min_length=3, max_length=450) = Field(
+        ...,
+        description='The sound in plain words, such as "glass shattering on a tile floor", up to 450 characters.',
+    )
+    duration: Literal["auto"] | confloat(ge=0.5, le=22.0) | None = Field(
+        "auto",
+        description="Length in seconds from 0.5 to 22, or auto to fit the sound; auto when left out.",
+    )
+    prompt_influence: confloat(ge=0.0, le=1.0) | None = Field(
+        0.3,
+        description="How closely the sound follows the prompt, from 0 to 1; 0.3 when left out.",
+    )
+    loop: bool | None = Field(
+        False,
+        description="Whether the sound loops seamlessly end to start; false when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateElevenlabsSoundEffects(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["elevenlabs/sound-effects"]
+    input: CreateElevenlabsSoundEffectsInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateElevenlabsVoiceChangerInput(BaseModel):
+    audio: str = Field(
+        ...,
+        description="The recording to re-voice, as an asset id (asset_…) or an https URL, at most 5 minutes; clean single-speaker audio works best.",
+    )
+    voice: constr(pattern=r"^[A-Za-z0-9]{20}$") = Field(
+        ...,
+        description="The voice id the recording is re-voiced into, from GET /v1/voices.",
+    )
+    remove_background_noise: bool | None = Field(
+        False,
+        description="Whether to strip background noise from the recording first; only for a noisy source, since it can hurt a clean one; false when left out.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateElevenlabsVoiceChanger(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["elevenlabs/voice-changer"]
+    input: CreateElevenlabsVoiceChangerInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateElevenlabsVoiceIsolatorInput(BaseModel):
+    audio: str = Field(
+        ...,
+        description="The audio to isolate the voice in, as an asset id (asset_…) or an https URL.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateElevenlabsVoiceIsolator(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["elevenlabs/voice-isolator"]
+    input: CreateElevenlabsVoiceIsolatorInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateMinimaxMusicInput(BaseModel):
+    prompt: constr(min_length=10, max_length=2000) = Field(
+        ...,
+        description="The style of the track: genre, mood, instruments, tempo and where it plays, from 10 to 2000 characters.",
+    )
+    lyrics: Literal["auto"] | constr(max_length=3500) | None = Field(
+        None,
+        description="The words to sing, a line per line with tags such as [Verse], [Chorus] and [Bridge], up to 3500 characters, or auto to have MiniMax write them from the prompt; none when left out or empty, which makes an instrumental.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateMinimaxMusic(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["minimax/music"]
+    input: CreateMinimaxMusicInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class CreateSoniloMusicInput(BaseModel):
+    prompt: constr(min_length=1) = Field(
+        ...,
+        description="The track: genre, mood, instruments, tempo and where it plays.",
+    )
+    duration: conint(ge=1, le=600) = Field(
+        ...,
+        description="Length in whole seconds from 1 to 600; the track runs exactly this long.",
+    )
+    name: constr(min_length=2, max_length=80) | None = Field(
+        None,
+        description="What the output is called in your library; made from the prompt when left out.",
+    )
+
+
+class CreateSoniloMusic(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    model: Literal["sonilo/music"]
+    input: CreateSoniloMusicInput
+    webhook_url: AnyUrl | None = Field(
+        None,
+        description="An https URL to POST a signed generation event to when it finishes",
+    )
+
+
+class GenerationOutputItemLayer(BaseModel):
+    name: str | None
+    description: str | None
+    x: float
+    y: float
+    width: float
+    height: float
+    z_index: float
+
+
+class GenerationOutputItem(BaseModel):
+    id: str
+    object: Literal["asset"]
+    type: Literal["image", "video", "audio"]
+    name: str | None
+    url: str
+    content_type: str
+    width: float | None = None
+    height: float | None = None
+    duration: float | None = None
+    role: Literal["main", "last_frame", "layer"]
+    layer: GenerationOutputItemLayer | None = None
+
+
+class GenerationError(BaseModel):
+    code: Literal["invalid_input", "insufficient_credits", "generation_failed"]
+    message: str
+
+
+class Generation(BaseModel):
+    id: str = Field(..., examples=["gen_6c1f0e9a7b2d4c55a1e3f08b9d2c4e71"])
+    object: Literal["generation"]
+    model: str
+    status: Literal["queued", "running", "succeeded", "failed", "canceled"] = (
+        Field(
+            ..., description="queued, then running, then succeeded, failed or canceled"
+        )
+    )
+    output: list[GenerationOutputItem] = Field(
+        ...,
+        description="What it made, saved to your library; the main file comes first",
+    )
+    error: GenerationError | None = Field(
+        ..., description="Why it failed; failed generations are free"
+    )
+    credits: float | None = Field(
+        ..., description="What it was charged, in credits of $0.05, once it finished"
+    )
+    created_at: str
+    started_at: str | None
+    completed_at: str | None
+
+
+class ModelPricingRate(BaseModel):
+    unit: str = Field(
+        ...,
+        description="What one rate is for: an image, a second, a minute, a character, a request or a token",
+    )
+    usd: float
+    when: dict[str, Any] = Field(
+        ...,
+        description="The input settings the rate applies to; empty when it applies to all",
+    )
+
+
+class ModelPricing(BaseModel):
+    rates: list[ModelPricingRate]
+
+
+class Model(BaseModel):
+    id: str
+    object: Literal["model"]
+    name: str
+    type: Literal["image", "video", "audio"]
+    task: str
+    summary: str
+    pricing: ModelPricing = Field(
+        ...,
+        description="What a generation costs per unit, in USD. A generation is charged in credits of $0.05, rounded up, and only when it succeeds.",
+    )
+    input_schema: dict[str, Any] = Field(..., description="The JSON Schema of `input`")
+
+
+class ErrorError(BaseModel):
+    type: Literal["invalid_request_error", "authentication_error", "permission_error", "not_found_error", "billing_error", "rate_limit_error", "api_error"]
+    code: str = Field(
+        ...,
+        description="A stable code to branch on, such as invalid_input or insufficient_credits",
+    )
+    message: str = Field(..., description="What went wrong and how to fix it")
+    param: str | None = Field(
+        None, description="The part of the request at fault, such as input.prompt"
+    )
+    request_id: str
+
+
+class Error(BaseModel):
+    error: ErrorError
+
+
+class GenerationList(BaseModel):
+    object: Literal["list"]
+    data: list[Generation]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )
+
+
+class LibraryAsset(BaseModel):
+    id: str
+    object: Literal["asset"]
+    type: Literal["image", "video", "audio", "file"]
+    name: str | None
+    url: str | None
+    content_type: str | None
+    width: float | None = None
+    height: float | None = None
+    duration: float | None = None
+    caption: str | None = Field(
+        ..., description="What the image shows, when it has been described"
+    )
+    liked: bool
+    offer: str | None = Field(
+        ..., description="The offer the file is a photo of, offer_…"
+    )
+    created_at: str
+
+
+class Asset(BaseModel):
+    id: str
+    object: Literal["asset"]
+    type: Literal["image", "video", "audio", "file"]
+    name: str | None
+    url: str | None
+    content_type: str | None
+    width: float | None = None
+    height: float | None = None
+    duration: float | None = None
+
+
+class BrandRule(BaseModel):
+    kind: Literal["preference", "taboo"]
+    text: str
+
+
+class BrandColor(BaseModel):
+    hex: str
+    role: str | None
+    name: str | None
+
+
+class BrandTypographyItem(BaseModel):
+    role: str = Field(
+        ..., description="heading1 to heading4, body, cta, link or overline"
+    )
+    font_family: str | None
+    font_size: str | None
+    font_weight: str | None
+    letter_spacing: str | None
+    text_transform: str | None
+
+
+class BrandButton(BaseModel):
+    text: str
+    color: str | None
+    background_color: str | None
+    border_radius: str | None
+    font_family: str | None
+    font_size: str | None
+    font_weight: str | None
+
+
+class BrandFontFile(BaseModel):
+    weight: str
+    style: str
+    url: str
+
+
+class BrandFont(BaseModel):
+    family: str
+    headings: bool
+    body: bool
+    files: list[BrandFontFile]
+
+
+class BrandLogo(BaseModel):
+    id: str = Field(..., description="An asset id, usable as a media input")
+    variant: Literal["icon", "light", "dark"] = Field(
+        ...,
+        description="icon for a small mark, light for dark backgrounds, dark for light ones",
+    )
+    format: str | None
+    width: float | None
+    height: float | None
+    url: str | None
+
+
+class Brand(BaseModel):
+    object: Literal["brand"]
+    id: UUID = Field(
+        ...,
+        description="Send it as `Sandstorm-Brand` to work on this brand with a key made on another",
+    )
+    name: str
+    summary: str | None
+    voice: str | None = Field(..., description="How the brand sounds, by surface")
+    audience: str | None
+    positioning: str | None
+    preferences: str | None = Field(
+        ..., description="Taboos and preferences found in what the brand published"
+    )
+    rules: list[BrandRule] = Field(
+        ...,
+        description="Rules people at the brand stated, newest first. They outrank everything above.",
+    )
+    colors: list[BrandColor]
+    typography: list[BrandTypographyItem]
+    button: BrandButton | None = Field(
+        ..., description="The site's primary call-to-action button"
+    )
+    fonts: list[BrandFont]
+    logos: list[BrandLogo]
+
+
+class OfferSummary(BaseModel):
+    id: str
+    object: Literal["offer"]
+    name: str
+    kind: str = Field(..., description="product, service, bundle")
+    priority: str = Field(..., description="hero, evergreen, seasonal")
+    summary: str
+    photo_count: int
+    variant_count: int
+
+
+class OfferVariantPhoto(BaseModel):
+    id: str = Field(..., description="An asset id, usable as a media input")
+    url: str | None
+    width: float | None
+    height: float | None
+    orientation: str | None
+    shot_type: str | None
+    caption: str | None
+    liked: bool
+
+
+class OfferVariant(BaseModel):
+    id: str
+    name: str
+    sku: str | None
+    price: str | None
+    compare_at_price: str | None
+    sizes: list[str]
+    photo_count: int
+    photos: list[OfferVariantPhoto]
+
+
+class OfferPhoto(BaseModel):
+    id: str = Field(..., description="An asset id, usable as a media input")
+    url: str | None
+    width: float | None
+    height: float | None
+    orientation: str | None
+    shot_type: str | None
+    caption: str | None
+    liked: bool
+
+
+class Offer(BaseModel):
+    id: str
+    object: Literal["offer"]
+    name: str
+    kind: str = Field(..., description="product, service, bundle")
+    priority: str = Field(..., description="hero, evergreen, seasonal")
+    photo_count: int
+    description: str | None
+    context: str | None = Field(..., description="Notes on how to sell it")
+    variants: list[OfferVariant]
+    photos: list[OfferPhoto] = Field(
+        ..., description="Photos of the offer that belong to no one variant"
+    )
+
+
+class CharacterItem(BaseModel):
+    asset: str = Field(..., description="An asset id, usable as a media input")
+    type: Literal["image", "video", "audio"]
+    role: str = Field(..., description="reference, first_frame, last_frame")
+    angle: str | None
+    usage: str | None
+    url: str | None
+
+
+class Character(BaseModel):
+    id: str
+    object: Literal["character"]
+    name: str
+    kind: str = Field(..., description="subject, product, place, voice, style")
+    description: str | None
+    usage: str | None
+    must_match: list[str] = Field(
+        ..., description="What every image of it has to keep, such as Face or Wardrobe"
+    )
+    items: list[CharacterItem]
+
+
+class Voice(BaseModel):
+    id: str = Field(..., description="Pass as `voice` to a voiceover or voice change")
+    object: Literal["voice"]
+    name: str
+    gender: str
+    age: str
+    accent: str
+    descriptive: str
+    use_case: str
+    description: str | None
+    preview_url: str | None = Field(..., description="A public sample to play")
+
+
+class Advertiser(BaseModel):
+    id: str
+    object: Literal["advertiser"]
+    name: str | None
+    ads: int
+    active_ads: int
+    followed: bool = Field(..., description="Whether your organization follows it")
+    sync: Literal["synced", "syncing", "failed", "never"]
+    synced_at: str | None
+
+
+class AdSummary(BaseModel):
+    id: str
+    object: Literal["ad"]
+    advertiser: str | None
+    advertiser_name: str | None
+    platform: str | None
+    format: str | None
+    status: str | None
+    title: str | None
+    body: str | None
+    cta_text: str | None
+    active_days: float | None
+    started_at: str | None
+    ad_library_url: str | None
+
+
+class Ad(BaseModel):
+    id: str
+    object: Literal["ad"]
+    advertiser: str | None
+    advertiser_name: str | None
+    platform: str | None
+    format: str | None
+    status: str | None
+    title: str | None
+    body: str | None
+    cta_text: str | None
+    active_days: float | None
+    started_at: str | None
+    ad_library_url: str | None
+    duration: float | None
+    caption: str | None
+    cta_type: str | None
+    link_url: str | None
+    link_description: str | None
+    ended_at: str | None
+    first_seen_at: str | None
+    last_seen_at: str | None
+    variants: float | None
+    transcript: str | None
+    media_url: str | None = Field(..., description="The ad's image or video")
+
+
+class PersonOrganization(BaseModel):
+    id: str
+    name: str | None
+    current: bool = Field(
+        ..., description="The organization Sandstorm opens for this person"
+    )
+    role: str | None
+    brand: str | None = Field(
+        ..., description="The brand this person last worked on there"
+    )
+
+
+class Person(BaseModel):
+    object: Literal["person"]
+    id: str
+    email: str | None
+    organizations: list[PersonOrganization]
+
+
+class ApiKeyOrganization(BaseModel):
+    id: str
+    name: str | None
+
+
+class ApiKeyBrand(BaseModel):
+    id: str
+    name: str | None
+
+
+class ApiKey(BaseModel):
+    object: Literal["api_key"]
+    id: str
+    name: str
+    key: str = Field(..., description="The key itself, shown this once")
+    prefix: str
+    organization: ApiKeyOrganization
+    brand: ApiKeyBrand | None
+    created_at: str
+
+
+class WebhookSecret(BaseModel):
+    object: Literal["webhook_secret"]
+    secret: str
+
+
+class CreateGeneration(
+    RootModel[
+        CreateNanoBananaPro
+        | CreateNanoBananaProEdit
+        | CreateNanoBanana2
+        | CreateNanoBanana2Edit
+        | CreateNanoBanana2Lite
+        | CreateNanoBanana2LiteEdit
+        | CreateGptImage25Flare
+        | CreateGptImage25FlareEdit
+        | CreateGptImage25Sunburst
+        | CreateGptImage25SunburstEdit
+        | CreateSeedream5Pro
+        | CreateSeedream5ProEdit
+        | CreateSeedream5Lite
+        | CreateSeedream5LiteEdit
+        | CreateSeedream5ProLayers
+        | CreateTopazUpscale
+        | CreateSeedance25TextToVideo
+        | CreateSeedance25ImageToVideo
+        | CreateSeedance25ReferenceToVideo
+        | CreateSeedance25Finish
+        | CreateKling3ProImageToVideo
+        | CreateKlingO3ProReferenceToVideo
+        | CreateGeminiOmniFlashTextToVideo
+        | CreateGeminiOmniFlashImageToVideo
+        | CreateGeminiOmniFlashReferenceToVideo
+        | CreateGeminiOmniFlashEdit
+        | CreateSync3Lipsync
+        | CreateElevenlabsVoiceover
+        | CreateElevenlabsMusic
+        | CreateElevenlabsSoundEffects
+        | CreateElevenlabsVoiceChanger
+        | CreateElevenlabsVoiceIsolator
+        | CreateMinimaxMusic
+        | CreateSoniloMusic
+    ]
+):
+    root: (
+        CreateNanoBananaPro
+        | CreateNanoBananaProEdit
+        | CreateNanoBanana2
+        | CreateNanoBanana2Edit
+        | CreateNanoBanana2Lite
+        | CreateNanoBanana2LiteEdit
+        | CreateGptImage25Flare
+        | CreateGptImage25FlareEdit
+        | CreateGptImage25Sunburst
+        | CreateGptImage25SunburstEdit
+        | CreateSeedream5Pro
+        | CreateSeedream5ProEdit
+        | CreateSeedream5Lite
+        | CreateSeedream5LiteEdit
+        | CreateSeedream5ProLayers
+        | CreateTopazUpscale
+        | CreateSeedance25TextToVideo
+        | CreateSeedance25ImageToVideo
+        | CreateSeedance25ReferenceToVideo
+        | CreateSeedance25Finish
+        | CreateKling3ProImageToVideo
+        | CreateKlingO3ProReferenceToVideo
+        | CreateGeminiOmniFlashTextToVideo
+        | CreateGeminiOmniFlashImageToVideo
+        | CreateGeminiOmniFlashReferenceToVideo
+        | CreateGeminiOmniFlashEdit
+        | CreateSync3Lipsync
+        | CreateElevenlabsVoiceover
+        | CreateElevenlabsMusic
+        | CreateElevenlabsSoundEffects
+        | CreateElevenlabsVoiceChanger
+        | CreateElevenlabsVoiceIsolator
+        | CreateMinimaxMusic
+        | CreateSoniloMusic
+    ) = Field(..., discriminator="model")
+
+
+class GenerationEvent(BaseModel):
+    id: str = Field(
+        ...,
+        description="The same for every delivery of one event, so a retry can be told apart",
+    )
+    object: Literal["event"]
+    type: Literal["generation.succeeded", "generation.failed", "generation.canceled"]
+    created_at: str
+    data: Generation
+
+
+class ModelList(BaseModel):
+    object: Literal["list"]
+    data: list[Model]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )
+
+
+class LibraryAssetList(BaseModel):
+    object: Literal["list"]
+    data: list[LibraryAsset]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )
+
+
+class OfferList(BaseModel):
+    object: Literal["list"]
+    data: list[OfferSummary]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )
+
+
+class CharacterList(BaseModel):
+    object: Literal["list"]
+    data: list[Character]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )
+
+
+class VoiceList(BaseModel):
+    object: Literal["list"]
+    data: list[Voice]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )
+
+
+class AdvertiserList(BaseModel):
+    object: Literal["list"]
+    data: list[Advertiser]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )
+
+
+class AdList(BaseModel):
+    object: Literal["list"]
+    data: list[AdSummary]
+    has_more: bool
+    next_cursor: str | None = Field(
+        ..., description="Pass as `cursor` for the next page"
+    )