From fa1c0f82b6c84cb6a7938cbe91e903adc84bb715 Mon Sep 17 00:00:00 2001 From: "sdk-github-actions[bot]" Date: Tue, 1 Sep 2026 19:10:13 +0000 Subject: [PATCH] chore(release): auto --- .sdk.json | 2 +- package-lock.json | 4 +-- package.json | 4 +-- src/environment.ts | 2 +- src/resources/v1/ai-clothes-changer/README.md | 2 +- src/resources/v1/ai-talking-photo/README.md | 4 +-- .../v1/ai-talking-photo/request-types.ts | 4 +-- src/resources/v1/image-to-video/README.md | 32 +++++++++---------- .../v1/image-to-video/request-types.ts | 32 ++++++++++++------- src/resources/v1/text-to-video/README.md | 24 +++++++------- .../v1/text-to-video/request-types.ts | 32 ++++++++++++------- ...er-create-body-assets-garment-type-enum.ts | 2 +- ...1-ai-clothes-changer-create-body-assets.ts | 2 +- src/types/v1-ai-talking-photo-create-body.ts | 4 +-- ...1-image-to-video-create-body-model-enum.ts | 26 ++++++++------- src/types/v1-image-to-video-create-body.ts | 32 ++++++++++++------- ...v1-text-to-video-create-body-model-enum.ts | 26 ++++++++------- src/types/v1-text-to-video-create-body.ts | 32 ++++++++++++------- 18 files changed, 151 insertions(+), 115 deletions(-) diff --git a/.sdk.json b/.sdk.json index ff71c1e..ba5da6c 100644 --- a/.sdk.json +++ b/.sdk.json @@ -1,5 +1,5 @@ { - "id": "162ebd5e-4d93-49e5-b1f4-80d4fb658b2f", + "id": "eee3cb82-29c6-4279-a54e-9a1b657400d9", "tracked_paths": [ { "editable": true, diff --git a/package-lock.json b/package-lock.json index 6c754eb..070f79e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "magic-hour", - "version": "0.71.3", + "version": "0.72.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "magic-hour", - "version": "0.71.3", + "version": "0.72.0", "license": "MIT", "dependencies": { "make-api-request-js": "^0.2.1", diff --git a/package.json b/package.json index 1e04f65..9aabfc6 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "magic-hour", - "version": "0.71.3", + "version": "0.72.0", "main": "./dist/index.js", "types": "./dist/index.d.ts", "exports": { @@ -69,4 +69,4 @@ "type": "git", "url": "https://github.com/magichourhq/magic-hour-node.git" } -} +} \ No newline at end of file diff --git a/src/environment.ts b/src/environment.ts index 89aaa60..1baa42d 100644 --- a/src/environment.ts +++ b/src/environment.ts @@ -1,4 +1,4 @@ export enum Environment { Environment = "https://api.magichour.ai", - MockServer = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.75.2", + MockServer = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.76.0", } diff --git a/src/resources/v1/ai-clothes-changer/README.md b/src/resources/v1/ai-clothes-changer/README.md index 1f88401..93b3be4 100644 --- a/src/resources/v1/ai-clothes-changer/README.md +++ b/src/resources/v1/ai-clothes-changer/README.md @@ -61,7 +61,7 @@ Change outfits in photos in seconds with just a photo reference. Each photo cost | -------------------- | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `assets` | ✓ | Provide the assets for clothes changer | `{"garmentFilePath": "api-assets/id/outfit.png", "garmentType": "entire_outfit", "personFilePath": "api-assets/id/model.png"}` | | `└─ garmentFilePath` | ✓ | The image of the outfit. 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/outfit.png"` | -| `└─ garmentType` | ✗ | Type of garment to swap. If not provided, swaps the entire outfit. * `upper_body` - for shirts/jackets * `lower_body` - for pants/skirts * `dresses` - for entire outfit (deprecated, use `entire_outfit` instead) * `entire_outfit` - for entire outfit | `"entire_outfit"` | +| `└─ garmentType` | ✗ | Type of clothing item to swap. If not provided, swaps the entire outfit. * `upper_body` - for shirts/jackets * `lower_body` - for pants/skirts * `dresses` - for entire outfit (deprecated, use `entire_outfit` instead) * `entire_outfit` - for entire outfit | `"entire_outfit"` | | `└─ personFilePath` | ✓ | The image with the person. 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/model.png"` | | `name` | ✗ | Give your image a custom name for easy identification. | `"My Clothes Changer image"` | diff --git a/src/resources/v1/ai-talking-photo/README.md b/src/resources/v1/ai-talking-photo/README.md index a4163a8..8e9b41e 100644 --- a/src/resources/v1/ai-talking-photo/README.md +++ b/src/resources/v1/ai-talking-photo/README.md @@ -63,8 +63,8 @@ Create a talking photo from an image and audio or text input. | `assets` | ✓ | Provide the assets for creating a talking photo | `{"audioFilePath": "api-assets/id/1234.mp3", "imageFilePath": "api-assets/id/1234.png"}` | | `└─ audioFilePath` | ✓ | The audio file to sync with the image. 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.mp3"` | | `└─ imageFilePath` | ✓ | The source image to animate. 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"` | -| `endSeconds` | ✓ | The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s. | `15.0` | -| `startSeconds` | ✓ | The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s. | `0.0` | +| `endSeconds` | ✓ | The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s. | `15.0` | +| `startSeconds` | ✓ | The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s. | `0.0` | | `maxResolution` | ✗ | Constrains the larger dimension (height or width) of the output video. Allows you to set a lower resolution than your plan's maximum if desired. The value is capped by your plan's max resolution. | `1024` | | `name` | ✗ | Give your image a custom name for easy identification. | `"My Talking Photo image"` | | `style` | ✗ | Attributes used to dictate the style of the output | `{"generationMode": "realistic"}` | diff --git a/src/resources/v1/ai-talking-photo/request-types.ts b/src/resources/v1/ai-talking-photo/request-types.ts index 4ddabb3..f953d46 100644 --- a/src/resources/v1/ai-talking-photo/request-types.ts +++ b/src/resources/v1/ai-talking-photo/request-types.ts @@ -21,7 +21,7 @@ export type CreateRequest = { */ assets: V1AiTalkingPhotoCreateBodyAssets; /** - * The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s. + * The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s. */ endSeconds: number; /** @@ -33,7 +33,7 @@ export type CreateRequest = { */ name?: string | undefined; /** - * The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s. + * The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s. */ startSeconds: number; /** diff --git a/src/resources/v1/image-to-video/README.md b/src/resources/v1/image-to-video/README.md index 6cf386b..f12a767 100644 --- a/src/resources/v1/image-to-video/README.md +++ b/src/resources/v1/image-to-video/README.md @@ -79,22 +79,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`. | `{"endImageFilePath": "api-assets/id/1234.png", "imageFilePath": "api-assets/id/1234.png"}` | -| `└─ endImageFilePath` | ✗ | — | The image to use as the last frame of the video. * **`kling-2.6`**: Supports 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`minimax-h3`**: Not supported * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Not supported * **`veo3.1`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`veo3.1-lite`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`wan-2.2`**: Not supported | `"api-assets/id/1234.png"` | -| `└─ imageFilePath` | ✓ | — | 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"` | -| `endSeconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`kling-2.6`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`minimax-h3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 * **`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 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 | `5.0` | -| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`kling-2.6`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`minimax-h3`**: Toggle-able: no additional credits for audio * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0`**: Toggle-able: no additional credits for audio * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.5`**: Toggle-able: no additional credits for audio * **`sora-2`**: Toggle-able: no additional credits for audio * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`wan-2.2`**: 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.3`. * `kling-2.6`: Great for action, motion blur, and camera moves. * `kling-3.0`: Best overall quality for cinematic storytelling. * `ltx-2.3`: Fastest output. Best for rapid iteration. * `minimax-h3`: Reference-driven video with native audio. * `seedance-1.5`: Smooth, consistent motion with precision. * `seedance-2.0`: Top quality with reference-to-video control. * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * `seedance-2.5`: Highest quality with superior realism, detail, and motion * `sora-2`: Open AI's model. Great for creativity and viral clips. * `veo3.1`: Google's model. Highest realism and detail. * `veo3.1-lite`: Veo quality at a more accessible cost. * `wan-2.2`: Strong physics, camera moves, and 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. * **`kling-2.6`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`minimax-h3`**: Supports 480p, 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. | `"720p"` | -| `style` | ✗ | ✗ | Attributed used to dictate the style of the output | `{"prompt": "a dog running"}` | -| `└─ highQuality` | ✗ | ✓ | 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"` | -| `└─ qualityMode` | ✗ | ✓ | 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`. | `{"endImageFilePath": "api-assets/id/1234.png", "imageFilePath": "api-assets/id/1234.png"}` | +| `└─ endImageFilePath` | ✗ | — | The image to use as the last frame of the video. * **`kling-2.6`**: Supports 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`minimax-h3`**: Not supported * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Not supported * **`veo3.1`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`veo3.1-lite`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`wan-2.2`**: Not supported | `"api-assets/id/1234.png"` | +| `└─ imageFilePath` | ✓ | — | 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"` | +| `endSeconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`kling-2.6`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`minimax-h3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 * **`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 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 | `5.0` | +| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`kling-2.6`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`minimax-h3`**: Toggle-able: no additional credits for audio * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0`**: Toggle-able: no additional credits for audio * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.5`**: Toggle-able: no additional credits for audio * **`sora-2`**: Toggle-able: no additional credits for audio * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`wan-2.2`**: 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.3`. * `kling-2.6`: Best for action, motion blur, and controlled camera moves. * `kling-3.0`: Best for cinematic stories, references, and optional audio. * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. * `seedance-1.5`: Best for smooth, consistent motion with an end frame. * `seedance-2.0`: Best for reference-led clips with precise subject control. * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. * `seedance-2.5`: Best for premium realism, detail, and natural motion. * `sora-2`: Best for creative concepts and longer clips with audio. * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. * `wan-2.2`: Best for physical motion, action, and camera movement. 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. * **`kling-2.6`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`minimax-h3`**: Supports 480p, 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. | `"720p"` | +| `style` | ✗ | ✗ | Attributed used to dictate the style of the output | `{"prompt": "a dog running"}` | +| `└─ highQuality` | ✗ | ✓ | 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"` | +| `└─ qualityMode` | ✗ | ✓ | 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` | #### Example Snippet diff --git a/src/resources/v1/image-to-video/request-types.ts b/src/resources/v1/image-to-video/request-types.ts index 99b5d12..57bcc91 100644 --- a/src/resources/v1/image-to-video/request-types.ts +++ b/src/resources/v1/image-to-video/request-types.ts @@ -67,24 +67,25 @@ export type CreateRequest = { * 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.3`. - * * `kling-2.6`: Great for action, motion blur, and camera moves. - * * `kling-3.0`: Best overall quality for cinematic storytelling. - * * `ltx-2.3`: Fastest output. Best for rapid iteration. - * * `minimax-h3`: Reference-driven video with native audio. - * * `seedance-1.5`: Smooth, consistent motion with precision. - * * `seedance-2.0`: Top quality with reference-to-video control. - * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality - * * `seedance-2.5`: Highest quality with superior realism, detail, and motion - * * `sora-2`: Open AI's model. Great for creativity and viral clips. - * * `veo3.1`: Google's model. Highest realism and detail. - * * `veo3.1-lite`: Veo quality at a more accessible cost. - * * `wan-2.2`: Strong physics, camera moves, and motion. + * * `kling-2.6`: Best for action, motion blur, and controlled camera moves. + * * `kling-3.0`: Best for cinematic stories, references, and optional audio. + * * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. + * * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. + * * `seedance-1.5`: Best for smooth, consistent motion with an end frame. + * * `seedance-2.0`: Best for reference-led clips with precise subject control. + * * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. + * * `seedance-2.5`: Best for premium realism, detail, and natural motion. + * * `sora-2`: Best for creative concepts and longer clips with audio. + * * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. + * * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. + * * `wan-2.2`: Best for physical motion, action, and camera movement. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. */ model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -92,6 +93,7 @@ export type CreateRequest = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -152,6 +154,7 @@ export type External$CreateRequest = { model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -159,6 +162,7 @@ export type External$CreateRequest = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -194,6 +198,7 @@ const SchemaIn$CreateRequest: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -201,6 +206,7 @@ const SchemaIn$CreateRequest: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5", @@ -250,6 +256,7 @@ const SchemaOut$CreateRequest: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -257,6 +264,7 @@ const SchemaOut$CreateRequest: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5", diff --git a/src/resources/v1/text-to-video/README.md b/src/resources/v1/text-to-video/README.md index 41a1e9d..dad62e3 100644 --- a/src/resources/v1/text-to-video/README.md +++ b/src/resources/v1/text-to-video/README.md @@ -80,18 +80,18 @@ For detailed examples, see the [product page](https://magichour.ai/products/text #### Parameters -| Parameter | Required | Deprecated | Description | Example | -| ---------------- | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | -| `endSeconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`kling-2.6`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`minimax-h3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 * **`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 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 | `5.0` | -| `style` | ✓ | ✗ | | `{"prompt": "a dog running"}` | -| `└─ prompt` | ✓ | — | The prompt used for the video. | `"a dog running"` | -| `└─ qualityMode` | ✗ | ✓ | 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"` | -| `aspectRatio` | ✗ | ✗ | Determines the aspect ratio of the output video. * **`kling-2.6`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`ltx-2.3`**: Supports 9:16, 16:9, 1:1. * **`minimax-h3`**: Supports 16:9, 9:16, 1:1. * **`seedance-1.5`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.5`**: 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. * **`wan-2.2`**: 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: * **`kling-2.6`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`minimax-h3`**: Toggle-able: no additional credits for audio * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0`**: Toggle-able: no additional credits for audio * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.5`**: Toggle-able: no additional credits for audio * **`sora-2`**: Toggle-able: no additional credits for audio * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`wan-2.2`**: 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.3`. * `kling-2.6`: Great for action, motion blur, and camera moves. * `kling-3.0`: Best overall quality for cinematic storytelling. * `ltx-2.3`: Fastest output. Best for rapid iteration. * `minimax-h3`: Reference-driven video with native audio. * `seedance-1.5`: Smooth, consistent motion with precision. * `seedance-2.0`: Top quality with reference-to-video control. * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * `seedance-2.5`: Highest quality with superior realism, detail, and motion * `sora-2`: Open AI's model. Great for creativity and viral clips. * `veo3.1`: Google's model. Highest realism and detail. * `veo3.1-lite`: Veo quality at a more accessible cost. * `wan-2.2`: Strong physics, camera moves, and 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. * **`kling-2.6`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`minimax-h3`**: Supports 480p, 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. | `"720p"` | +| Parameter | Required | Deprecated | Description | Example | +| ---------------- | :------: | :--------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | +| `endSeconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`kling-2.6`**: 5, 10 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`minimax-h3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 * **`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 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 | `5.0` | +| `style` | ✓ | ✗ | | `{"prompt": "a dog running"}` | +| `└─ prompt` | ✓ | — | The prompt used for the video. | `"a dog running"` | +| `└─ qualityMode` | ✗ | ✓ | 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"` | +| `aspectRatio` | ✗ | ✗ | Determines the aspect ratio of the output video. * **`kling-2.6`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`ltx-2.3`**: Supports 9:16, 16:9, 1:1. * **`minimax-h3`**: Supports 16:9, 9:16, 1:1. * **`seedance-1.5`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.5`**: 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. * **`wan-2.2`**: 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: * **`kling-2.6`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`minimax-h3`**: Toggle-able: no additional credits for audio * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0`**: Toggle-able: no additional credits for audio * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.5`**: Toggle-able: no additional credits for audio * **`sora-2`**: Toggle-able: no additional credits for audio * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`wan-2.2`**: 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.3`. * `kling-2.6`: Best for action, motion blur, and controlled camera moves. * `kling-3.0`: Best for cinematic stories, references, and optional audio. * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. * `seedance-1.5`: Best for smooth, consistent motion with an end frame. * `seedance-2.0`: Best for reference-led clips with precise subject control. * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. * `seedance-2.5`: Best for premium realism, detail, and natural motion. * `sora-2`: Best for creative concepts and longer clips with audio. * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. * `wan-2.2`: Best for physical motion, action, and camera movement. 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. * **`kling-2.6`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`minimax-h3`**: Supports 480p, 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. * **`veo3.1`**: Supports 720p, 1080p. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. | `"720p"` | #### Example Snippet diff --git a/src/resources/v1/text-to-video/request-types.ts b/src/resources/v1/text-to-video/request-types.ts index 1c06ab1..af980d8 100644 --- a/src/resources/v1/text-to-video/request-types.ts +++ b/src/resources/v1/text-to-video/request-types.ts @@ -70,24 +70,25 @@ export type CreateRequest = { * 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.3`. - * * `kling-2.6`: Great for action, motion blur, and camera moves. - * * `kling-3.0`: Best overall quality for cinematic storytelling. - * * `ltx-2.3`: Fastest output. Best for rapid iteration. - * * `minimax-h3`: Reference-driven video with native audio. - * * `seedance-1.5`: Smooth, consistent motion with precision. - * * `seedance-2.0`: Top quality with reference-to-video control. - * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality - * * `seedance-2.5`: Highest quality with superior realism, detail, and motion - * * `sora-2`: Open AI's model. Great for creativity and viral clips. - * * `veo3.1`: Google's model. Highest realism and detail. - * * `veo3.1-lite`: Veo quality at a more accessible cost. - * * `wan-2.2`: Strong physics, camera moves, and motion. + * * `kling-2.6`: Best for action, motion blur, and controlled camera moves. + * * `kling-3.0`: Best for cinematic stories, references, and optional audio. + * * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. + * * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. + * * `seedance-1.5`: Best for smooth, consistent motion with an end frame. + * * `seedance-2.0`: Best for reference-led clips with precise subject control. + * * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. + * * `seedance-2.5`: Best for premium realism, detail, and natural motion. + * * `sora-2`: Best for creative concepts and longer clips with audio. + * * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. + * * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. + * * `wan-2.2`: Best for physical motion, action, and camera movement. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. */ model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -95,6 +96,7 @@ export type CreateRequest = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -149,6 +151,7 @@ export type External$CreateRequest = { model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -156,6 +159,7 @@ export type External$CreateRequest = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -190,6 +194,7 @@ const SchemaIn$CreateRequest: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -197,6 +202,7 @@ const SchemaIn$CreateRequest: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5", @@ -244,6 +250,7 @@ const SchemaOut$CreateRequest: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -251,6 +258,7 @@ const SchemaOut$CreateRequest: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5", diff --git a/src/types/v1-ai-clothes-changer-create-body-assets-garment-type-enum.ts b/src/types/v1-ai-clothes-changer-create-body-assets-garment-type-enum.ts index b70e2e9..eb63769 100644 --- a/src/types/v1-ai-clothes-changer-create-body-assets-garment-type-enum.ts +++ b/src/types/v1-ai-clothes-changer-create-body-assets-garment-type-enum.ts @@ -1,5 +1,5 @@ /** - * Type of garment to swap. If not provided, swaps the entire outfit. + * Type of clothing item to swap. If not provided, swaps the entire outfit. * * `upper_body` - for shirts/jackets * * `lower_body` - for pants/skirts * * `dresses` - for entire outfit (deprecated, use `entire_outfit` instead) diff --git a/src/types/v1-ai-clothes-changer-create-body-assets.ts b/src/types/v1-ai-clothes-changer-create-body-assets.ts index 27293d0..d8f06fd 100644 --- a/src/types/v1-ai-clothes-changer-create-body-assets.ts +++ b/src/types/v1-ai-clothes-changer-create-body-assets.ts @@ -15,7 +15,7 @@ export type V1AiClothesChangerCreateBodyAssets = { */ garmentFilePath: string; /** - * Type of garment to swap. If not provided, swaps the entire outfit. + * Type of clothing item to swap. If not provided, swaps the entire outfit. * * `upper_body` - for shirts/jackets * * `lower_body` - for pants/skirts * * `dresses` - for entire outfit (deprecated, use `entire_outfit` instead) diff --git a/src/types/v1-ai-talking-photo-create-body.ts b/src/types/v1-ai-talking-photo-create-body.ts index 71cc94e..326c570 100644 --- a/src/types/v1-ai-talking-photo-create-body.ts +++ b/src/types/v1-ai-talking-photo-create-body.ts @@ -21,7 +21,7 @@ export type V1AiTalkingPhotoCreateBody = { */ assets: V1AiTalkingPhotoCreateBodyAssets; /** - * The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s. + * The end time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s. */ endSeconds: number; /** @@ -33,7 +33,7 @@ export type V1AiTalkingPhotoCreateBody = { */ name?: string | undefined; /** - * The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 180s, prompted 45s. + * The start time of the input audio in seconds. Maximum clip length depends on style.generation_mode: realistic 300s, prompted 45s. */ startSeconds: number; /** diff --git a/src/types/v1-image-to-video-create-body-model-enum.ts b/src/types/v1-image-to-video-create-body-model-enum.ts index 1713c16..d43ddd5 100644 --- a/src/types/v1-image-to-video-create-body-model-enum.ts +++ b/src/types/v1-image-to-video-create-body-model-enum.ts @@ -2,23 +2,24 @@ * 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.3`. - * * `kling-2.6`: Great for action, motion blur, and camera moves. - * * `kling-3.0`: Best overall quality for cinematic storytelling. - * * `ltx-2.3`: Fastest output. Best for rapid iteration. - * * `minimax-h3`: Reference-driven video with native audio. - * * `seedance-1.5`: Smooth, consistent motion with precision. - * * `seedance-2.0`: Top quality with reference-to-video control. - * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality - * * `seedance-2.5`: Highest quality with superior realism, detail, and motion - * * `sora-2`: Open AI's model. Great for creativity and viral clips. - * * `veo3.1`: Google's model. Highest realism and detail. - * * `veo3.1-lite`: Veo quality at a more accessible cost. - * * `wan-2.2`: Strong physics, camera moves, and motion. + * * `kling-2.6`: Best for action, motion blur, and controlled camera moves. + * * `kling-3.0`: Best for cinematic stories, references, and optional audio. + * * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. + * * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. + * * `seedance-1.5`: Best for smooth, consistent motion with an end frame. + * * `seedance-2.0`: Best for reference-led clips with precise subject control. + * * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. + * * `seedance-2.5`: Best for premium realism, detail, and natural motion. + * * `sora-2`: Best for creative concepts and longer clips with audio. + * * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. + * * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. + * * `wan-2.2`: Best for physical motion, action, and camera movement. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. */ export type V1ImageToVideoCreateBodyModelEnum = | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -26,6 +27,7 @@ export type V1ImageToVideoCreateBodyModelEnum = | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" diff --git a/src/types/v1-image-to-video-create-body.ts b/src/types/v1-image-to-video-create-body.ts index 6af5405..22d6d55 100644 --- a/src/types/v1-image-to-video-create-body.ts +++ b/src/types/v1-image-to-video-create-body.ts @@ -67,24 +67,25 @@ export type V1ImageToVideoCreateBody = { * 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.3`. - * * `kling-2.6`: Great for action, motion blur, and camera moves. - * * `kling-3.0`: Best overall quality for cinematic storytelling. - * * `ltx-2.3`: Fastest output. Best for rapid iteration. - * * `minimax-h3`: Reference-driven video with native audio. - * * `seedance-1.5`: Smooth, consistent motion with precision. - * * `seedance-2.0`: Top quality with reference-to-video control. - * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality - * * `seedance-2.5`: Highest quality with superior realism, detail, and motion - * * `sora-2`: Open AI's model. Great for creativity and viral clips. - * * `veo3.1`: Google's model. Highest realism and detail. - * * `veo3.1-lite`: Veo quality at a more accessible cost. - * * `wan-2.2`: Strong physics, camera moves, and motion. + * * `kling-2.6`: Best for action, motion blur, and controlled camera moves. + * * `kling-3.0`: Best for cinematic stories, references, and optional audio. + * * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. + * * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. + * * `seedance-1.5`: Best for smooth, consistent motion with an end frame. + * * `seedance-2.0`: Best for reference-led clips with precise subject control. + * * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. + * * `seedance-2.5`: Best for premium realism, detail, and natural motion. + * * `sora-2`: Best for creative concepts and longer clips with audio. + * * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. + * * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. + * * `wan-2.2`: Best for physical motion, action, and camera movement. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. */ model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -92,6 +93,7 @@ export type V1ImageToVideoCreateBody = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -152,6 +154,7 @@ export type External$V1ImageToVideoCreateBody = { model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -159,6 +162,7 @@ export type External$V1ImageToVideoCreateBody = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -194,6 +198,7 @@ const SchemaIn$V1ImageToVideoCreateBody: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -201,6 +206,7 @@ const SchemaIn$V1ImageToVideoCreateBody: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5", @@ -250,6 +256,7 @@ const SchemaOut$V1ImageToVideoCreateBody: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -257,6 +264,7 @@ const SchemaOut$V1ImageToVideoCreateBody: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5", diff --git a/src/types/v1-text-to-video-create-body-model-enum.ts b/src/types/v1-text-to-video-create-body-model-enum.ts index b2b6686..9ff13b5 100644 --- a/src/types/v1-text-to-video-create-body-model-enum.ts +++ b/src/types/v1-text-to-video-create-body-model-enum.ts @@ -2,23 +2,24 @@ * 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.3`. - * * `kling-2.6`: Great for action, motion blur, and camera moves. - * * `kling-3.0`: Best overall quality for cinematic storytelling. - * * `ltx-2.3`: Fastest output. Best for rapid iteration. - * * `minimax-h3`: Reference-driven video with native audio. - * * `seedance-1.5`: Smooth, consistent motion with precision. - * * `seedance-2.0`: Top quality with reference-to-video control. - * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality - * * `seedance-2.5`: Highest quality with superior realism, detail, and motion - * * `sora-2`: Open AI's model. Great for creativity and viral clips. - * * `veo3.1`: Google's model. Highest realism and detail. - * * `veo3.1-lite`: Veo quality at a more accessible cost. - * * `wan-2.2`: Strong physics, camera moves, and motion. + * * `kling-2.6`: Best for action, motion blur, and controlled camera moves. + * * `kling-3.0`: Best for cinematic stories, references, and optional audio. + * * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. + * * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. + * * `seedance-1.5`: Best for smooth, consistent motion with an end frame. + * * `seedance-2.0`: Best for reference-led clips with precise subject control. + * * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. + * * `seedance-2.5`: Best for premium realism, detail, and natural motion. + * * `sora-2`: Best for creative concepts and longer clips with audio. + * * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. + * * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. + * * `wan-2.2`: Best for physical motion, action, and camera movement. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. */ export type V1TextToVideoCreateBodyModelEnum = | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -26,6 +27,7 @@ export type V1TextToVideoCreateBodyModelEnum = | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" diff --git a/src/types/v1-text-to-video-create-body.ts b/src/types/v1-text-to-video-create-body.ts index 4391942..22f580d 100644 --- a/src/types/v1-text-to-video-create-body.ts +++ b/src/types/v1-text-to-video-create-body.ts @@ -70,24 +70,25 @@ export type V1TextToVideoCreateBody = { * 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.3`. - * * `kling-2.6`: Great for action, motion blur, and camera moves. - * * `kling-3.0`: Best overall quality for cinematic storytelling. - * * `ltx-2.3`: Fastest output. Best for rapid iteration. - * * `minimax-h3`: Reference-driven video with native audio. - * * `seedance-1.5`: Smooth, consistent motion with precision. - * * `seedance-2.0`: Top quality with reference-to-video control. - * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality - * * `seedance-2.5`: Highest quality with superior realism, detail, and motion - * * `sora-2`: Open AI's model. Great for creativity and viral clips. - * * `veo3.1`: Google's model. Highest realism and detail. - * * `veo3.1-lite`: Veo quality at a more accessible cost. - * * `wan-2.2`: Strong physics, camera moves, and motion. + * * `kling-2.6`: Best for action, motion blur, and controlled camera moves. + * * `kling-3.0`: Best for cinematic stories, references, and optional audio. + * * `ltx-2.3`: Fastest for general scenes, long clips, audio, and rapid iteration. + * * `minimax-h3`: Great for reference-driven clips with native audio and longer durations. + * * `seedance-1.5`: Best for smooth, consistent motion with an end frame. + * * `seedance-2.0`: Best for reference-led clips with precise subject control. + * * `seedance-2.0-mini`: Faster reference-led clips with consistent motion and audio. + * * `seedance-2.5`: Best for premium realism, detail, and natural motion. + * * `sora-2`: Best for creative concepts and longer clips with audio. + * * `veo3.1`: Best for romantic interactions and expressive action, with realistic detail. + * * `veo3.1-lite`: Balanced realism and audio at a lower cost than Veo 3.1. + * * `wan-2.2`: Best for physical motion, action, and camera movement. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. */ model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -95,6 +96,7 @@ export type V1TextToVideoCreateBody = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -149,6 +151,7 @@ export type External$V1TextToVideoCreateBody = { model?: | ( | "default" + | "google-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -156,6 +159,7 @@ export type External$V1TextToVideoCreateBody = { | "kling-3.0" | "ltx-2" | "ltx-2.3" + | "ltx-2.5" | "minimax-h3" | "seedance" | "seedance-1.5" @@ -190,6 +194,7 @@ const SchemaIn$V1TextToVideoCreateBody: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -197,6 +202,7 @@ const SchemaIn$V1TextToVideoCreateBody: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5", @@ -244,6 +250,7 @@ const SchemaOut$V1TextToVideoCreateBody: z.ZodType< model: z .enum([ "default", + "google-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -251,6 +258,7 @@ const SchemaOut$V1TextToVideoCreateBody: z.ZodType< "kling-3.0", "ltx-2", "ltx-2.3", + "ltx-2.5", "minimax-h3", "seedance", "seedance-1.5",