From cf8a0f8e915076aa185c477d7d3bb0ad964caefb Mon Sep 17 00:00:00 2001 From: "sdk-github-actions[bot]" Date: Mon, 6 Apr 2026 19:26:14 +0000 Subject: [PATCH] chore(release): auto --- .sdk.json | 2 +- magic_hour/environment.py | 2 +- .../resources/v1/image_to_video/README.md | 32 +++++------ .../resources/v1/image_to_video/client.py | 52 +++++++++++------ .../resources/v1/text_to_video/README.md | 24 ++++---- .../resources/v1/text_to_video/client.py | 56 +++++++++++++------ .../models/v1_image_projects_get_response.py | 2 +- .../params/v1_image_to_video_create_body.py | 28 +++++++--- .../v1_image_to_video_create_body_assets.py | 2 + .../params/v1_text_to_video_create_body.py | 30 +++++++--- pyproject.toml | 2 +- 11 files changed, 152 insertions(+), 80 deletions(-) diff --git a/.sdk.json b/.sdk.json index 74b2ea2..2349904 100644 --- a/.sdk.json +++ b/.sdk.json @@ -1,5 +1,5 @@ { - "id": "01c627ac-ebeb-4e1d-8067-9836f219afd9", + "id": "546e1877-5fc9-48f8-af87-100072c9c2fc", "tracked_paths": [ { "editable": true, diff --git a/magic_hour/environment.py b/magic_hour/environment.py index 4df55b6..e887fee 100644 --- a/magic_hour/environment.py +++ b/magic_hour/environment.py @@ -6,7 +6,7 @@ class Environment(enum.Enum): """Pre-defined base URLs for the API""" ENVIRONMENT = "https://api.magichour.ai" - MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.59.0" + MOCK_SERVER = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.60.0" def _get_base_url( diff --git a/magic_hour/resources/v1/image_to_video/README.md b/magic_hour/resources/v1/image_to_video/README.md index 739d951..abd034f 100644 --- a/magic_hour/resources/v1/image_to_video/README.md +++ b/magic_hour/resources/v1/image_to_video/README.md @@ -94,22 +94,22 @@ For detailed examples, see the [product page](https://magichour.ai/products/imag #### Parameters -| Parameter | Required | Deprecated | Description | Example | -| ------------------------ | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | -| `assets` | ✓ | ✗ | Provide the assets for image-to-video. Sora 2 only supports images with an aspect ratio of `9:16` or `16:9`. | `{"end_image_file_path": "api-assets/id/1234.png", "image_file_path": "api-assets/id/1234.png"}` | -| `└─ end_image_file_path` | ✗ | — | The image to use as the last frame of the video. * **`ltx-2`**: Not supported * **`wan-2.2`**: Not supported * **`seedance`**: Supports 480p, 720p, 1080p. * **`kling-2.5`**: Supports 1080p. * **`kling-3.0`**: Supports 1080p. * **`sora-2`**: Not supported * **`veo3.1`**: Not supported Legacy models: * **`kling-1.6`**: Not supported | `"api-assets/id/1234.png"` | -| `└─ image_file_path` | ✓ | — | The path of the image file. This value is either - a direct URL to the video file - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls). See the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details. | `"api-assets/id/1234.png"` | -| `end_seconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 | `5.0` | -| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) Legacy models: * **`kling-1.6`**: Not supported | `True` | -| `height` | ✗ | ✓ | `height` is deprecated and no longer influences the output video's resolution. This field is retained only for backward compatibility and will be removed in a future release. | `123` | -| `model` | ✗ | ✗ | The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. * `seedance`: Great for fast iteration and start/end frame * `kling-2.5`: Great for motion, action, and camera control * `kling-3.0`: Great for cinematic, multi-scene storytelling with control * `sora-2`: Great for story-telling, dialogue & creativity * `veo3.1`: Great for realism, polish, & prompt adherence Legacy models: * `kling-1.6`: Great for dependable clips with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | -| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Image To Video video"` | -| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. | `"720p"` | -| `style` | ✗ | ✗ | Attributed used to dictate the style of the output | `{"prompt": "a dog running"}` | -| `└─ high_quality` | ✗ | ✓ | Deprecated: Please use `resolution` instead. For backward compatibility, * `false` maps to 720p resolution * `true` maps to 1080p resolution This field will be removed in a future version. Use the `resolution` field to directly specify the resolution. | `True` | -| `└─ prompt` | ✗ | — | The prompt used for the video. | `"a dog running"` | -| `└─ quality_mode` | ✗ | ✓ | DEPRECATED: Please use `resolution` field instead. For backward compatibility: * `quick` maps to 720p resolution * `studio` maps to 1080p resolution This field will be removed in a future version. Use the `resolution` field to directly to specify the resolution. | `"quick"` | -| `width` | ✗ | ✓ | `width` is deprecated and no longer influences the output video's resolution. This field is retained only for backward compatibility and will be removed in a future release. | `123` | +| Parameter | Required | Deprecated | Description | Example | +| ------------------------ | :------: | :--------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | +| `assets` | ✓ | ✗ | Provide the assets for image-to-video. Sora 2 only supports images with an aspect ratio of `9:16` or `16:9`. | `{"end_image_file_path": "api-assets/id/1234.png", "image_file_path": "api-assets/id/1234.png"}` | +| `└─ end_image_file_path` | ✗ | — | The image to use as the last frame of the video. * **`ltx-2`**: Not supported * **`wan-2.2`**: Not supported * **`seedance`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 1080p. * **`kling-3.0`**: Supports 1080p. * **`sora-2`**: Not supported * **`veo3.1`**: Not supported * **`veo3.1-lite`**: Not supported Legacy models: * **`kling-1.6`**: Not supported | `"api-assets/id/1234.png"` | +| `└─ image_file_path` | ✓ | — | The path of the image file. This value is either - a direct URL to the video file - `file_path` field from the response of the [upload urls API](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls). See the [file upload guide](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls#input-file) for details. | `"api-assets/id/1234.png"` | +| `end_seconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 | `5.0` | +| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported | `True` | +| `height` | ✗ | ✓ | `height` is deprecated and no longer influences the output video's resolution. This field is retained only for backward compatibility and will be removed in a future release. | `123` | +| `model` | ✗ | ✗ | The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. * `ltx-2`: Fast iteration with audio and lip-sync * `wan-2.2`: Fast, strong visuals with effects * `seedance`: Fast iteration and start/end frames * `seedance-2.0`: State-of-the-art quality and consistency * `kling-2.5`: Motion, action, and camera control * `kling-3.0`: Cinematic, multi-scene storytelling * `sora-2`: Story-first concepts and creativity * `veo3.1`: Realistic visuals and prompt adherence * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | +| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Image To Video video"` | +| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. | `"720p"` | +| `style` | ✗ | ✗ | Attributed used to dictate the style of the output | `{"prompt": "a dog running"}` | +| `└─ high_quality` | ✗ | ✓ | Deprecated: Please use `resolution` instead. For backward compatibility, * `false` maps to 720p resolution * `true` maps to 1080p resolution This field will be removed in a future version. Use the `resolution` field to directly specify the resolution. | `True` | +| `└─ prompt` | ✗ | — | The prompt used for the video. | `"a dog running"` | +| `└─ quality_mode` | ✗ | ✓ | DEPRECATED: Please use `resolution` field instead. For backward compatibility: * `quick` maps to 720p resolution * `studio` maps to 1080p resolution This field will be removed in a future version. Use the `resolution` field to directly to specify the resolution. | `"quick"` | +| `width` | ✗ | ✓ | `width` is deprecated and no longer influences the output video's resolution. This field is retained only for backward compatibility and will be removed in a future release. | `123` | #### Synchronous Client diff --git a/magic_hour/resources/v1/image_to_video/client.py b/magic_hour/resources/v1/image_to_video/client.py index 9024e72..32f15c8 100644 --- a/magic_hour/resources/v1/image_to_video/client.py +++ b/magic_hour/resources/v1/image_to_video/client.py @@ -153,9 +153,11 @@ def create( "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ], @@ -211,10 +213,12 @@ def create( * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported + * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) + * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported @@ -224,16 +228,18 @@ def create( model: The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. - * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces - * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. - * `seedance`: Great for fast iteration and start/end frame - * `kling-2.5`: Great for motion, action, and camera control - * `kling-3.0`: Great for cinematic, multi-scene storytelling with control - * `sora-2`: Great for story-telling, dialogue & creativity - * `veo3.1`: Great for realism, polish, & prompt adherence + * `ltx-2`: Fast iteration with audio and lip-sync + * `wan-2.2`: Fast, strong visuals with effects + * `seedance`: Fast iteration and start/end frames + * `seedance-2.0`: State-of-the-art quality and consistency + * `kling-2.5`: Motion, action, and camera control + * `kling-3.0`: Cinematic, multi-scene storytelling + * `sora-2`: Story-first concepts and creativity + * `veo3.1`: Realistic visuals and prompt adherence + * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: - * `kling-1.6`: Great for dependable clips with smooth motion + * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. name: Give your video a custom name for easy identification. @@ -242,10 +248,12 @@ def create( * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. + * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. + * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. @@ -259,10 +267,12 @@ def create( * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 + * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 + * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 @@ -446,9 +456,11 @@ async def create( "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ], @@ -504,10 +516,12 @@ async def create( * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported + * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) + * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported @@ -517,16 +531,18 @@ async def create( model: The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. - * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces - * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. - * `seedance`: Great for fast iteration and start/end frame - * `kling-2.5`: Great for motion, action, and camera control - * `kling-3.0`: Great for cinematic, multi-scene storytelling with control - * `sora-2`: Great for story-telling, dialogue & creativity - * `veo3.1`: Great for realism, polish, & prompt adherence + * `ltx-2`: Fast iteration with audio and lip-sync + * `wan-2.2`: Fast, strong visuals with effects + * `seedance`: Fast iteration and start/end frames + * `seedance-2.0`: State-of-the-art quality and consistency + * `kling-2.5`: Motion, action, and camera control + * `kling-3.0`: Cinematic, multi-scene storytelling + * `sora-2`: Story-first concepts and creativity + * `veo3.1`: Realistic visuals and prompt adherence + * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: - * `kling-1.6`: Great for dependable clips with smooth motion + * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. name: Give your video a custom name for easy identification. @@ -535,10 +551,12 @@ async def create( * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. + * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. + * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. @@ -552,10 +570,12 @@ async def create( * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 + * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 + * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 diff --git a/magic_hour/resources/v1/text_to_video/README.md b/magic_hour/resources/v1/text_to_video/README.md index b89f588..cb90677 100644 --- a/magic_hour/resources/v1/text_to_video/README.md +++ b/magic_hour/resources/v1/text_to_video/README.md @@ -96,18 +96,18 @@ For detailed examples, see the [product page](https://magichour.ai/products/text #### Parameters -| Parameter | Required | Deprecated | Description | Example | -| ----------------- | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | -| `end_seconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 | `5.0` | -| `style` | ✓ | ✗ | | `{"prompt": "a dog running"}` | -| `└─ prompt` | ✓ | — | The prompt used for the video. | `"a dog running"` | -| `└─ quality_mode` | ✗ | ✓ | DEPRECATED: Please use `resolution` field instead. For backward compatibility: * `quick` maps to 720p resolution * `studio` maps to 1080p resolution This field will be removed in a future version. Use the `resolution` field to directly to specify the resolution. | `"quick"` | -| `aspect_ratio` | ✗ | ✗ | Determines the aspect ratio of the output video. * **`ltx-2`**: Supports 9:16, 16:9, 1:1. * **`wan-2.2`**: Supports 9:16, 16:9, 1:1. * **`seedance`**: Supports 9:16, 16:9, 1:1. * **`kling-2.5`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`sora-2`**: Supports 9:16, 16:9. * **`veo3.1`**: Supports 9:16, 16:9. Legacy models: * **`kling-1.6`**: Supports 9:16, 16:9, 1:1. | `"16:9"` | -| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) Legacy models: * **`kling-1.6`**: Not supported | `True` | -| `model` | ✗ | ✗ | The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. * `seedance`: Great for fast iteration and start/end frame * `kling-2.5`: Great for motion, action, and camera control * `kling-3.0`: Great for cinematic, multi-scene storytelling with control * `sora-2`: Great for story-telling, dialogue & creativity * `veo3.1`: Great for realism, polish, & prompt adherence Legacy models: * `kling-1.6`: Great for dependable clips with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | -| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Text To Video video"` | -| `orientation` | ✗ | ✓ | Deprecated. Use `aspect_ratio` instead. | `"landscape"` | -| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. | `"720p"` | +| Parameter | Required | Deprecated | Description | Example | +| ----------------- | :------: | :--------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | +| `end_seconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 | `5.0` | +| `style` | ✓ | ✗ | | `{"prompt": "a dog running"}` | +| `└─ prompt` | ✓ | — | The prompt used for the video. | `"a dog running"` | +| `└─ quality_mode` | ✗ | ✓ | DEPRECATED: Please use `resolution` field instead. For backward compatibility: * `quick` maps to 720p resolution * `studio` maps to 1080p resolution This field will be removed in a future version. Use the `resolution` field to directly to specify the resolution. | `"quick"` | +| `aspect_ratio` | ✗ | ✗ | Determines the aspect ratio of the output video. * **`ltx-2`**: Supports 9:16, 16:9, 1:1. * **`wan-2.2`**: Supports 9:16, 16:9, 1:1. * **`seedance`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`kling-2.5`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`sora-2`**: Supports 9:16, 16:9. * **`veo3.1`**: Supports 9:16, 16:9. * **`veo3.1-lite`**: Supports 9:16, 16:9. Legacy models: * **`kling-1.6`**: Supports 9:16, 16:9, 1:1. | `"16:9"` | +| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported | `True` | +| `model` | ✗ | ✗ | The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. * `ltx-2`: Fast iteration with audio and lip-sync * `wan-2.2`: Fast, strong visuals with effects * `seedance`: Fast iteration and start/end frames * `seedance-2.0`: State-of-the-art quality and consistency * `kling-2.5`: Motion, action, and camera control * `kling-3.0`: Cinematic, multi-scene storytelling * `sora-2`: Story-first concepts and creativity * `veo3.1`: Realistic visuals and prompt adherence * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | +| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Text To Video video"` | +| `orientation` | ✗ | ✓ | Deprecated. Use `aspect_ratio` instead. | `"landscape"` | +| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. | `"720p"` | #### Synchronous Client diff --git a/magic_hour/resources/v1/text_to_video/client.py b/magic_hour/resources/v1/text_to_video/client.py index d0e50e8..bdc7f8f 100644 --- a/magic_hour/resources/v1/text_to_video/client.py +++ b/magic_hour/resources/v1/text_to_video/client.py @@ -146,9 +146,11 @@ def create( "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ], @@ -203,10 +205,12 @@ def create( * **`ltx-2`**: Supports 9:16, 16:9, 1:1. * **`wan-2.2`**: Supports 9:16, 16:9, 1:1. * **`seedance`**: Supports 9:16, 16:9, 1:1. + * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`kling-2.5`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`sora-2`**: Supports 9:16, 16:9. * **`veo3.1`**: Supports 9:16, 16:9. + * **`veo3.1-lite`**: Supports 9:16, 16:9. Legacy models: * **`kling-1.6`**: Supports 9:16, 16:9, 1:1. @@ -216,26 +220,30 @@ def create( * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported + * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) + * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported model: The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. - * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces - * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. - * `seedance`: Great for fast iteration and start/end frame - * `kling-2.5`: Great for motion, action, and camera control - * `kling-3.0`: Great for cinematic, multi-scene storytelling with control - * `sora-2`: Great for story-telling, dialogue & creativity - * `veo3.1`: Great for realism, polish, & prompt adherence + * `ltx-2`: Fast iteration with audio and lip-sync + * `wan-2.2`: Fast, strong visuals with effects + * `seedance`: Fast iteration and start/end frames + * `seedance-2.0`: State-of-the-art quality and consistency + * `kling-2.5`: Motion, action, and camera control + * `kling-3.0`: Cinematic, multi-scene storytelling + * `sora-2`: Story-first concepts and creativity + * `veo3.1`: Realistic visuals and prompt adherence + * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: - * `kling-1.6`: Great for dependable clips with smooth motion + * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. name: Give your video a custom name for easy identification. @@ -245,10 +253,12 @@ def create( * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. + * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. + * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. @@ -257,10 +267,12 @@ def create( * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 + * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 + * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 @@ -432,9 +444,11 @@ async def create( "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ], @@ -489,10 +503,12 @@ async def create( * **`ltx-2`**: Supports 9:16, 16:9, 1:1. * **`wan-2.2`**: Supports 9:16, 16:9, 1:1. * **`seedance`**: Supports 9:16, 16:9, 1:1. + * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`kling-2.5`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`sora-2`**: Supports 9:16, 16:9. * **`veo3.1`**: Supports 9:16, 16:9. + * **`veo3.1-lite`**: Supports 9:16, 16:9. Legacy models: * **`kling-1.6`**: Supports 9:16, 16:9, 1:1. @@ -502,26 +518,30 @@ async def create( * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported + * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) + * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported model: The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. - * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces - * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. - * `seedance`: Great for fast iteration and start/end frame - * `kling-2.5`: Great for motion, action, and camera control - * `kling-3.0`: Great for cinematic, multi-scene storytelling with control - * `sora-2`: Great for story-telling, dialogue & creativity - * `veo3.1`: Great for realism, polish, & prompt adherence + * `ltx-2`: Fast iteration with audio and lip-sync + * `wan-2.2`: Fast, strong visuals with effects + * `seedance`: Fast iteration and start/end frames + * `seedance-2.0`: State-of-the-art quality and consistency + * `kling-2.5`: Motion, action, and camera control + * `kling-3.0`: Cinematic, multi-scene storytelling + * `sora-2`: Story-first concepts and creativity + * `veo3.1`: Realistic visuals and prompt adherence + * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: - * `kling-1.6`: Great for dependable clips with smooth motion + * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. name: Give your video a custom name for easy identification. @@ -531,10 +551,12 @@ async def create( * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. + * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. + * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. @@ -543,10 +565,12 @@ async def create( * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 + * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 + * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 diff --git a/magic_hour/types/models/v1_image_projects_get_response.py b/magic_hour/types/models/v1_image_projects_get_response.py index 306f37e..b4d67f6 100644 --- a/magic_hour/types/models/v1_image_projects_get_response.py +++ b/magic_hour/types/models/v1_image_projects_get_response.py @@ -80,5 +80,5 @@ class V1ImageProjectsGetResponse(pydantic.BaseModel): alias="type", ) """ - The type of the image project. Possible values are AI_HEADSHOT, AI_IMAGE, IMAGE_UPSCALER, FACE_SWAP, PHOTO_EDITOR, QR_CODE, BACKGROUND_REMOVER, CLOTHES_CHANGER, AI_MEME, FACE_EDITOR, PHOTO_COLORIZER, AI_GIF, AI_SELFIE, AI_IMAGE_EDITOR, HEAD_SWAP, STORYBOARD + The type of the image project. Possible values are AI_HEADSHOT, AI_IMAGE, IMAGE_UPSCALER, FACE_SWAP, PHOTO_EDITOR, QR_CODE, BACKGROUND_REMOVER, CLOTHES_CHANGER, AI_MEME, FACE_EDITOR, PHOTO_COLORIZER, AI_GIF, AI_SELFIE, AI_IMAGE_EDITOR, HEAD_SWAP, STORYBOARD, BODY_SWAP """ diff --git a/magic_hour/types/params/v1_image_to_video_create_body.py b/magic_hour/types/params/v1_image_to_video_create_body.py index e0af3b9..c034a3d 100644 --- a/magic_hour/types/params/v1_image_to_video_create_body.py +++ b/magic_hour/types/params/v1_image_to_video_create_body.py @@ -30,10 +30,12 @@ class V1ImageToVideoCreateBody(typing_extensions.TypedDict): * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported + * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) + * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported @@ -46,10 +48,12 @@ class V1ImageToVideoCreateBody(typing_extensions.TypedDict): * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 + * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 + * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 @@ -71,9 +75,11 @@ class V1ImageToVideoCreateBody(typing_extensions.TypedDict): "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ] @@ -81,16 +87,18 @@ class V1ImageToVideoCreateBody(typing_extensions.TypedDict): The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. - * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces - * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. - * `seedance`: Great for fast iteration and start/end frame - * `kling-2.5`: Great for motion, action, and camera control - * `kling-3.0`: Great for cinematic, multi-scene storytelling with control - * `sora-2`: Great for story-telling, dialogue & creativity - * `veo3.1`: Great for realism, polish, & prompt adherence + * `ltx-2`: Fast iteration with audio and lip-sync + * `wan-2.2`: Fast, strong visuals with effects + * `seedance`: Fast iteration and start/end frames + * `seedance-2.0`: State-of-the-art quality and consistency + * `kling-2.5`: Motion, action, and camera control + * `kling-3.0`: Cinematic, multi-scene storytelling + * `sora-2`: Story-first concepts and creativity + * `veo3.1`: Realistic visuals and prompt adherence + * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: - * `kling-1.6`: Great for dependable clips with smooth motion + * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. """ @@ -109,10 +117,12 @@ class V1ImageToVideoCreateBody(typing_extensions.TypedDict): * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. + * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. + * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. @@ -158,9 +168,11 @@ class _SerializerV1ImageToVideoCreateBody(pydantic.BaseModel): "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ] = pydantic.Field(alias="model", default=None) diff --git a/magic_hour/types/params/v1_image_to_video_create_body_assets.py b/magic_hour/types/params/v1_image_to_video_create_body_assets.py index 3933242..fc0c321 100644 --- a/magic_hour/types/params/v1_image_to_video_create_body_assets.py +++ b/magic_hour/types/params/v1_image_to_video_create_body_assets.py @@ -15,10 +15,12 @@ class V1ImageToVideoCreateBodyAssets(typing_extensions.TypedDict): * **`ltx-2`**: Not supported * **`wan-2.2`**: Not supported * **`seedance`**: Supports 480p, 720p, 1080p. + * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 1080p. * **`kling-3.0`**: Supports 1080p. * **`sora-2`**: Not supported * **`veo3.1`**: Not supported + * **`veo3.1-lite`**: Not supported Legacy models: * **`kling-1.6`**: Not supported diff --git a/magic_hour/types/params/v1_text_to_video_create_body.py b/magic_hour/types/params/v1_text_to_video_create_body.py index 2afc0dd..da21b6e 100644 --- a/magic_hour/types/params/v1_text_to_video_create_body.py +++ b/magic_hour/types/params/v1_text_to_video_create_body.py @@ -22,10 +22,12 @@ class V1TextToVideoCreateBody(typing_extensions.TypedDict): * **`ltx-2`**: Supports 9:16, 16:9, 1:1. * **`wan-2.2`**: Supports 9:16, 16:9, 1:1. * **`seedance`**: Supports 9:16, 16:9, 1:1. + * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`kling-2.5`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`sora-2`**: Supports 9:16, 16:9. * **`veo3.1`**: Supports 9:16, 16:9. + * **`veo3.1-lite`**: Supports 9:16, 16:9. Legacy models: * **`kling-1.6`**: Supports 9:16, 16:9, 1:1. @@ -39,10 +41,12 @@ class V1TextToVideoCreateBody(typing_extensions.TypedDict): * **`ltx-2`**: Automatically included with no extra credits * **`wan-2.2`**: Not supported * **`seedance`**: Not supported + * **`seedance-2.0`**: Not supported * **`kling-2.5`**: Automatically included with no extra credits * **`kling-3.0`**: Toggle-able (can enable/disable) * **`sora-2`**: Automatically included with no extra credits * **`veo3.1`**: Toggle-able (can enable/disable) + * **`veo3.1-lite`**: Automatically included with no extra credits Legacy models: * **`kling-1.6`**: Not supported @@ -55,10 +59,12 @@ class V1TextToVideoCreateBody(typing_extensions.TypedDict): * **`ltx-2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`seedance`**: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 + * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`kling-2.5`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 + * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 Legacy models: * **`kling-1.6`**: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 @@ -73,9 +79,11 @@ class V1TextToVideoCreateBody(typing_extensions.TypedDict): "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ] @@ -83,16 +91,18 @@ class V1TextToVideoCreateBody(typing_extensions.TypedDict): The AI model to use for video generation. * `default`: uses our currently recommended model for general use. For paid tiers, defaults to `kling-3.0`. For free tiers, it defaults to `ltx-2`. - * `ltx-2`: Great for fast iteration with audio, lip-sync, and expressive faces - * `wan-2.2`: Fast, medium-quality model with strong visuals and effect support. - * `seedance`: Great for fast iteration and start/end frame - * `kling-2.5`: Great for motion, action, and camera control - * `kling-3.0`: Great for cinematic, multi-scene storytelling with control - * `sora-2`: Great for story-telling, dialogue & creativity - * `veo3.1`: Great for realism, polish, & prompt adherence + * `ltx-2`: Fast iteration with audio and lip-sync + * `wan-2.2`: Fast, strong visuals with effects + * `seedance`: Fast iteration and start/end frames + * `seedance-2.0`: State-of-the-art quality and consistency + * `kling-2.5`: Motion, action, and camera control + * `kling-3.0`: Cinematic, multi-scene storytelling + * `sora-2`: Story-first concepts and creativity + * `veo3.1`: Realistic visuals and prompt adherence + * `veo3.1-lite`: Good for fast, affordable, high-quality daily generation. Legacy models: - * `kling-1.6`: Great for dependable clips with smooth motion + * `kling-1.6`: Reliable baseline with smooth motion If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. """ @@ -118,10 +128,12 @@ class V1TextToVideoCreateBody(typing_extensions.TypedDict): * **`ltx-2`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`seedance`**: Supports 480p, 720p, 1080p. + * **`seedance-2.0`**: Supports 480p, 720p. * **`kling-2.5`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. + * **`veo3.1-lite`**: Supports 720p, 1080p. Legacy models: * **`kling-1.6`**: Supports 720p, 1080p. @@ -156,9 +168,11 @@ class _SerializerV1TextToVideoCreateBody(pydantic.BaseModel): "kling-3.0", "ltx-2", "seedance", + "seedance-2.0", "sora-2", "veo3.1", "veo3.1-audio", + "veo3.1-lite", "wan-2.2", ] ] = pydantic.Field(alias="model", default=None) diff --git a/pyproject.toml b/pyproject.toml index 4418b8e..8de2242 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "magic_hour" -version = "0.59.0" +version = "0.60.0" description = "Python SDK for Magic Hour API" readme = "README.md" authors = []