diff --git a/.sdk.json b/.sdk.json index ba5da6c..467ebed 100644 --- a/.sdk.json +++ b/.sdk.json @@ -1,5 +1,5 @@ { - "id": "eee3cb82-29c6-4279-a54e-9a1b657400d9", + "id": "063a5d83-3d58-4579-beca-9cfebbb892bc", "tracked_paths": [ { "editable": true, diff --git a/package-lock.json b/package-lock.json index c29f9ff..f01c62a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "magic-hour", - "version": "0.72.0", + "version": "0.73.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "magic-hour", - "version": "0.72.0", + "version": "0.73.0", "license": "MIT", "dependencies": { "make-api-request-js": "^0.2.1", diff --git a/package.json b/package.json index 9aabfc6..32494d2 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "magic-hour", - "version": "0.72.0", + "version": "0.73.0", "main": "./dist/index.js", "types": "./dist/index.d.ts", "exports": { diff --git a/src/environment.ts b/src/environment.ts index 1baa42d..aa6766b 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.76.0", + MockServer = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.77.0", } diff --git a/src/resources/v1/ai-video-editor/README.md b/src/resources/v1/ai-video-editor/README.md index 7043c08..6bbe996 100644 --- a/src/resources/v1/ai-video-editor/README.md +++ b/src/resources/v1/ai-video-editor/README.md @@ -84,12 +84,12 @@ For detailed examples, see the [product page](https://magichour.ai/products/ai-v | ------------------ | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- | | `assets` | ✓ | Provide the assets for video editing. | `{"videoFilePath": "api-assets/id/1234.mp4"}` | | `└─ videoFilePath` | ✓ | The video to edit. 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.mp4"` | -| `endSeconds` | ✓ | End time of your clip in seconds. Must be greater than `start_seconds`. Minimum duration depends on model: `gemini-omni`: 3s, `ltx-2.3`: 0.5s. Maximum duration depends on model: `gemini-omni`: 10s, `ltx-2.3`: 45s. | `5.0` | +| `endSeconds` | ✓ | End time of your clip in seconds. Must be greater than `start_seconds`. Minimum duration depends on model: `gemini-omni-1.1`: 3s, `ltx-2.3`: 0.5s. Maximum duration depends on model: `gemini-omni-1.1`: 10s, `ltx-2.3`: 45s. | `5.0` | | `style` | ✓ | | `{"prompt": "Change the car color to blue"}` | | `└─ prompt` | ✓ | The prompt used to edit the video. | `"Change the car color to blue"` | -| `model` | ✗ | Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni` for paid. Use `ltx-2.3` for LTX video edit. | `"gemini-omni"` | +| `model` | ✗ | Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni-1.1` for paid. `gemini-omni` is deprecated; use `gemini-omni-1.1` instead. | `"gemini-omni-1.1"` | | `name` | ✗ | Give your video a custom name for easy identification. | `"My Video Editor video"` | -| `resolution` | ✗ | Output resolution. Defaults to `480p` for free tier and `720p` for paid. Google Omni supports 720p only; LTX-2.3 supports 480p, 720p, and 1080p. | `"720p"` | +| `resolution` | ✗ | Output resolution. Defaults to `480p` for free tier and `720p` for paid. `gemini-omni-1.1` and deprecated `gemini-omni` support 720p and 1080p; LTX-2.3 supports 480p, 720p, and 1080p. | `"720p"` | | `startSeconds` | ✗ | Start time of your clip (seconds). Must be ≥ 0. | `0.0` | #### Example Snippet @@ -101,7 +101,7 @@ const client = new Client({ token: process.env["API_TOKEN"]!! }); const res = await client.v1.aiVideoEditor.create({ assets: { videoFilePath: "api-assets/id/1234.mp4" }, endSeconds: 5.0, - model: "gemini-omni", + model: "gemini-omni-1.1", name: "My Video Editor video", resolution: "720p", startSeconds: 0.0, diff --git a/src/resources/v1/ai-video-editor/request-types.ts b/src/resources/v1/ai-video-editor/request-types.ts index 2241cd3..266b9e2 100644 --- a/src/resources/v1/ai-video-editor/request-types.ts +++ b/src/resources/v1/ai-video-editor/request-types.ts @@ -21,19 +21,19 @@ export type CreateRequest = { */ assets: V1AiVideoEditorCreateBodyAssets; /** - * End time of your clip in seconds. Must be greater than `start_seconds`. Minimum duration depends on model: `gemini-omni`: 3s, `ltx-2.3`: 0.5s. Maximum duration depends on model: `gemini-omni`: 10s, `ltx-2.3`: 45s. + * End time of your clip in seconds. Must be greater than `start_seconds`. Minimum duration depends on model: `gemini-omni-1.1`: 3s, `ltx-2.3`: 0.5s. Maximum duration depends on model: `gemini-omni-1.1`: 10s, `ltx-2.3`: 45s. */ endSeconds: number; /** - * Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni` for paid. Use `ltx-2.3` for LTX video edit. + * Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni-1.1` for paid. `gemini-omni` is deprecated; use `gemini-omni-1.1` instead. */ - model?: ("gemini-omni" | "ltx-2.3") | undefined; + model?: ("gemini-omni" | "gemini-omni-1.1" | "ltx-2.3") | undefined; /** * Give your video a custom name for easy identification. */ name?: string | undefined; /** - * Output resolution. Defaults to `480p` for free tier and `720p` for paid. Google Omni supports 720p only; LTX-2.3 supports 480p, 720p, and 1080p. + * Output resolution. Defaults to `480p` for free tier and `720p` for paid. `gemini-omni-1.1` and deprecated `gemini-omni` support 720p and 1080p; LTX-2.3 supports 480p, 720p, and 1080p. */ resolution?: ("1080p" | "480p" | "720p") | undefined; /** @@ -51,7 +51,7 @@ export type CreateRequest = { export type External$CreateRequest = { assets: External$V1AiVideoEditorCreateBodyAssets; end_seconds: number; - model?: ("gemini-omni" | "ltx-2.3") | undefined; + model?: ("gemini-omni" | "gemini-omni-1.1" | "ltx-2.3") | undefined; name?: string | undefined; resolution?: ("1080p" | "480p" | "720p") | undefined; start_seconds?: number | undefined; @@ -69,7 +69,7 @@ const SchemaIn$CreateRequest: z.ZodType< .object({ assets: Schemas$V1AiVideoEditorCreateBodyAssets.in, end_seconds: z.number(), - model: z.enum(["gemini-omni", "ltx-2.3"]).optional(), + model: z.enum(["gemini-omni", "gemini-omni-1.1", "ltx-2.3"]).optional(), name: z.string().optional(), resolution: z.enum(["1080p", "480p", "720p"]).optional(), start_seconds: z.number().optional(), @@ -99,7 +99,7 @@ const SchemaOut$CreateRequest: z.ZodType< .object({ assets: Schemas$V1AiVideoEditorCreateBodyAssets.out, endSeconds: z.number(), - model: z.enum(["gemini-omni", "ltx-2.3"]).optional(), + model: z.enum(["gemini-omni", "gemini-omni-1.1", "ltx-2.3"]).optional(), name: z.string().optional(), resolution: z.enum(["1080p", "480p", "720p"]).optional(), startSeconds: z.number().optional(), diff --git a/src/resources/v1/image-to-video/README.md b/src/resources/v1/image-to-video/README.md index f12a767..452498b 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`: 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` | +| 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. * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * **`kling-2.6`**: Supports 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`ltx-2.5`**: 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: * **`gemini-omni-1.1`**: 3, 4, 5, 6, 7, 8, 9, 10 * **`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 * **`ltx-2.5`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 * **`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: * **`gemini-omni-1.1`**: Not supported * **`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 * **`ltx-2.5`**: 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`. * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * `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. * `ltx-2.5`: 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. * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * **`kling-2.6`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`ltx-2.5`**: 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 57bcc91..dcd9157 100644 --- a/src/resources/v1/image-to-video/request-types.ts +++ b/src/resources/v1/image-to-video/request-types.ts @@ -24,9 +24,11 @@ export type CreateRequest = { * Whether to include audio in the video. Defaults to `false` if not specified. * * Audio support varies by model: + * * **`gemini-omni-1.1`**: Not supported * * **`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 + * * **`ltx-2.5`**: 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 @@ -42,9 +44,11 @@ export type CreateRequest = { /** * The total duration of the output video in seconds. Supported durations depend on the chosen model: * + * * **`gemini-omni-1.1`**: 3, 4, 5, 6, 7, 8, 9, 10 * * **`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 + * * **`ltx-2.5`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 * * **`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 @@ -67,9 +71,11 @@ 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`. + * * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * * `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. + * * `ltx-2.5`: 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. @@ -85,7 +91,7 @@ export type CreateRequest = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -114,9 +120,11 @@ export type CreateRequest = { /** * Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * + * * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * * **`kling-2.6`**: Supports 720p, 1080p. * * **`kling-3.0`**: Supports 720p, 1080p, 4k. * * **`ltx-2.3`**: Supports 480p, 720p, 1080p. + * * **`ltx-2.5`**: Supports 480p, 720p, 1080p. * * **`minimax-h3`**: Supports 480p, 720p, 1080p. * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0`**: Supports 480p, 720p. @@ -154,7 +162,7 @@ export type External$CreateRequest = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -198,7 +206,7 @@ const SchemaIn$CreateRequest: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -256,7 +264,7 @@ const SchemaOut$CreateRequest: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", diff --git a/src/resources/v1/text-to-video/README.md b/src/resources/v1/text-to-video/README.md index dad62e3..f4d33e1 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`: 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"` | +| Parameter | Required | Deprecated | Description | Example | +| ---------------- | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | +| `endSeconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`gemini-omni-1.1`**: 3, 4, 5, 6, 7, 8, 9, 10 * **`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 * **`ltx-2.5`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 * **`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. * **`gemini-omni-1.1`**: Supports 16:9, 9:16. * **`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. * **`ltx-2.5`**: 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: * **`gemini-omni-1.1`**: Not supported * **`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 * **`ltx-2.5`**: 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`. * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * `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. * `ltx-2.5`: 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. * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * **`kling-2.6`**: Supports 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`ltx-2.5`**: 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 af980d8..a91996b 100644 --- a/src/resources/v1/text-to-video/request-types.ts +++ b/src/resources/v1/text-to-video/request-types.ts @@ -14,9 +14,11 @@ export type CreateRequest = { /** * Determines the aspect ratio of the output video. * + * * **`gemini-omni-1.1`**: Supports 16:9, 9:16. * * **`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. + * * **`ltx-2.5`**: 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. @@ -33,9 +35,11 @@ export type CreateRequest = { * Whether to include audio in the video. Defaults to `false` if not specified. * * Audio support varies by model: + * * **`gemini-omni-1.1`**: Not supported * * **`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 + * * **`ltx-2.5`**: 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 @@ -51,9 +55,11 @@ export type CreateRequest = { /** * The total duration of the output video in seconds. Supported durations depend on the chosen model: * + * * **`gemini-omni-1.1`**: 3, 4, 5, 6, 7, 8, 9, 10 * * **`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 + * * **`ltx-2.5`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 * * **`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 @@ -70,9 +76,11 @@ 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`. + * * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * * `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. + * * `ltx-2.5`: 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. @@ -88,7 +96,7 @@ export type CreateRequest = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -121,9 +129,11 @@ export type CreateRequest = { /** * Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * + * * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * * **`kling-2.6`**: Supports 720p, 1080p. * * **`kling-3.0`**: Supports 720p, 1080p, 4k. * * **`ltx-2.3`**: Supports 480p, 720p, 1080p. + * * **`ltx-2.5`**: Supports 480p, 720p, 1080p. * * **`minimax-h3`**: Supports 480p, 720p, 1080p. * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0`**: Supports 480p, 720p. @@ -151,7 +161,7 @@ export type External$CreateRequest = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -194,7 +204,7 @@ const SchemaIn$CreateRequest: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -250,7 +260,7 @@ const SchemaOut$CreateRequest: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", diff --git a/src/types/v1-ai-video-editor-create-body-model-enum.ts b/src/types/v1-ai-video-editor-create-body-model-enum.ts index 9fe9b20..40d7653 100644 --- a/src/types/v1-ai-video-editor-create-body-model-enum.ts +++ b/src/types/v1-ai-video-editor-create-body-model-enum.ts @@ -1,4 +1,7 @@ /** - * Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni` for paid. Use `ltx-2.3` for LTX video edit. + * Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni-1.1` for paid. `gemini-omni` is deprecated; use `gemini-omni-1.1` instead. */ -export type V1AiVideoEditorCreateBodyModelEnum = "gemini-omni" | "ltx-2.3"; +export type V1AiVideoEditorCreateBodyModelEnum = + | "gemini-omni" + | "gemini-omni-1.1" + | "ltx-2.3"; diff --git a/src/types/v1-ai-video-editor-create-body-resolution-enum.ts b/src/types/v1-ai-video-editor-create-body-resolution-enum.ts index b689820..8e667a4 100644 --- a/src/types/v1-ai-video-editor-create-body-resolution-enum.ts +++ b/src/types/v1-ai-video-editor-create-body-resolution-enum.ts @@ -1,4 +1,4 @@ /** - * Output resolution. Defaults to `480p` for free tier and `720p` for paid. Google Omni supports 720p only; LTX-2.3 supports 480p, 720p, and 1080p. + * Output resolution. Defaults to `480p` for free tier and `720p` for paid. `gemini-omni-1.1` and deprecated `gemini-omni` support 720p and 1080p; LTX-2.3 supports 480p, 720p, and 1080p. */ export type V1AiVideoEditorCreateBodyResolutionEnum = "1080p" | "480p" | "720p"; diff --git a/src/types/v1-ai-video-editor-create-body.ts b/src/types/v1-ai-video-editor-create-body.ts index c0c9581..99d6037 100644 --- a/src/types/v1-ai-video-editor-create-body.ts +++ b/src/types/v1-ai-video-editor-create-body.ts @@ -21,19 +21,19 @@ export type V1AiVideoEditorCreateBody = { */ assets: V1AiVideoEditorCreateBodyAssets; /** - * End time of your clip in seconds. Must be greater than `start_seconds`. Minimum duration depends on model: `gemini-omni`: 3s, `ltx-2.3`: 0.5s. Maximum duration depends on model: `gemini-omni`: 10s, `ltx-2.3`: 45s. + * End time of your clip in seconds. Must be greater than `start_seconds`. Minimum duration depends on model: `gemini-omni-1.1`: 3s, `ltx-2.3`: 0.5s. Maximum duration depends on model: `gemini-omni-1.1`: 10s, `ltx-2.3`: 45s. */ endSeconds: number; /** - * Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni` for paid. Use `ltx-2.3` for LTX video edit. + * Editing model. Defaults to `ltx-2.3` for free tier and `gemini-omni-1.1` for paid. `gemini-omni` is deprecated; use `gemini-omni-1.1` instead. */ - model?: ("gemini-omni" | "ltx-2.3") | undefined; + model?: ("gemini-omni" | "gemini-omni-1.1" | "ltx-2.3") | undefined; /** * Give your video a custom name for easy identification. */ name?: string | undefined; /** - * Output resolution. Defaults to `480p` for free tier and `720p` for paid. Google Omni supports 720p only; LTX-2.3 supports 480p, 720p, and 1080p. + * Output resolution. Defaults to `480p` for free tier and `720p` for paid. `gemini-omni-1.1` and deprecated `gemini-omni` support 720p and 1080p; LTX-2.3 supports 480p, 720p, and 1080p. */ resolution?: ("1080p" | "480p" | "720p") | undefined; /** @@ -51,7 +51,7 @@ export type V1AiVideoEditorCreateBody = { export type External$V1AiVideoEditorCreateBody = { assets: External$V1AiVideoEditorCreateBodyAssets; end_seconds: number; - model?: ("gemini-omni" | "ltx-2.3") | undefined; + model?: ("gemini-omni" | "gemini-omni-1.1" | "ltx-2.3") | undefined; name?: string | undefined; resolution?: ("1080p" | "480p" | "720p") | undefined; start_seconds?: number | undefined; @@ -69,7 +69,7 @@ const SchemaIn$V1AiVideoEditorCreateBody: z.ZodType< .object({ assets: Schemas$V1AiVideoEditorCreateBodyAssets.in, end_seconds: z.number(), - model: z.enum(["gemini-omni", "ltx-2.3"]).optional(), + model: z.enum(["gemini-omni", "gemini-omni-1.1", "ltx-2.3"]).optional(), name: z.string().optional(), resolution: z.enum(["1080p", "480p", "720p"]).optional(), start_seconds: z.number().optional(), @@ -99,7 +99,7 @@ const SchemaOut$V1AiVideoEditorCreateBody: z.ZodType< .object({ assets: Schemas$V1AiVideoEditorCreateBodyAssets.out, endSeconds: z.number(), - model: z.enum(["gemini-omni", "ltx-2.3"]).optional(), + model: z.enum(["gemini-omni", "gemini-omni-1.1", "ltx-2.3"]).optional(), name: z.string().optional(), resolution: z.enum(["1080p", "480p", "720p"]).optional(), startSeconds: z.number().optional(), diff --git a/src/types/v1-image-to-video-create-body-assets.ts b/src/types/v1-image-to-video-create-body-assets.ts index a241f46..48b1a25 100644 --- a/src/types/v1-image-to-video-create-body-assets.ts +++ b/src/types/v1-image-to-video-create-body-assets.ts @@ -8,9 +8,11 @@ export type V1ImageToVideoCreateBodyAssets = { /** * The image to use as the last frame of the video. * + * * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * * **`kling-2.6`**: Supports 1080p. * * **`kling-3.0`**: Supports 720p, 1080p, 4k. * * **`ltx-2.3`**: Supports 480p, 720p, 1080p. + * * **`ltx-2.5`**: Supports 480p, 720p, 1080p. * * **`minimax-h3`**: Not supported * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0`**: Supports 480p, 720p. 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 d43ddd5..7939c24 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,9 +2,11 @@ * 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`. + * * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * * `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. + * * `ltx-2.5`: 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. @@ -19,7 +21,7 @@ */ export type V1ImageToVideoCreateBodyModelEnum = | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" diff --git a/src/types/v1-image-to-video-create-body-resolution-enum.ts b/src/types/v1-image-to-video-create-body-resolution-enum.ts index 178b3d3..898a93d 100644 --- a/src/types/v1-image-to-video-create-body-resolution-enum.ts +++ b/src/types/v1-image-to-video-create-body-resolution-enum.ts @@ -1,9 +1,11 @@ /** * Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * + * * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * * **`kling-2.6`**: Supports 720p, 1080p. * * **`kling-3.0`**: Supports 720p, 1080p, 4k. * * **`ltx-2.3`**: Supports 480p, 720p, 1080p. + * * **`ltx-2.5`**: Supports 480p, 720p, 1080p. * * **`minimax-h3`**: Supports 480p, 720p, 1080p. * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0`**: Supports 480p, 720p. diff --git a/src/types/v1-image-to-video-create-body.ts b/src/types/v1-image-to-video-create-body.ts index 22d6d55..b39d2a2 100644 --- a/src/types/v1-image-to-video-create-body.ts +++ b/src/types/v1-image-to-video-create-body.ts @@ -24,9 +24,11 @@ export type V1ImageToVideoCreateBody = { * Whether to include audio in the video. Defaults to `false` if not specified. * * Audio support varies by model: + * * **`gemini-omni-1.1`**: Not supported * * **`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 + * * **`ltx-2.5`**: 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 @@ -42,9 +44,11 @@ export type V1ImageToVideoCreateBody = { /** * The total duration of the output video in seconds. Supported durations depend on the chosen model: * + * * **`gemini-omni-1.1`**: 3, 4, 5, 6, 7, 8, 9, 10 * * **`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 + * * **`ltx-2.5`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 * * **`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 @@ -67,9 +71,11 @@ 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`. + * * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * * `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. + * * `ltx-2.5`: 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. @@ -85,7 +91,7 @@ export type V1ImageToVideoCreateBody = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -114,9 +120,11 @@ export type V1ImageToVideoCreateBody = { /** * Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * + * * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * * **`kling-2.6`**: Supports 720p, 1080p. * * **`kling-3.0`**: Supports 720p, 1080p, 4k. * * **`ltx-2.3`**: Supports 480p, 720p, 1080p. + * * **`ltx-2.5`**: Supports 480p, 720p, 1080p. * * **`minimax-h3`**: Supports 480p, 720p, 1080p. * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0`**: Supports 480p, 720p. @@ -154,7 +162,7 @@ export type External$V1ImageToVideoCreateBody = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -198,7 +206,7 @@ const SchemaIn$V1ImageToVideoCreateBody: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -256,7 +264,7 @@ const SchemaOut$V1ImageToVideoCreateBody: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", diff --git a/src/types/v1-text-to-video-create-body-aspect-ratio-enum.ts b/src/types/v1-text-to-video-create-body-aspect-ratio-enum.ts index 9ae7348..c32a66f 100644 --- a/src/types/v1-text-to-video-create-body-aspect-ratio-enum.ts +++ b/src/types/v1-text-to-video-create-body-aspect-ratio-enum.ts @@ -1,9 +1,11 @@ /** * Determines the aspect ratio of the output video. * + * * **`gemini-omni-1.1`**: Supports 16:9, 9:16. * * **`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. + * * **`ltx-2.5`**: 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. 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 9ff13b5..7199516 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,9 +2,11 @@ * 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`. + * * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * * `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. + * * `ltx-2.5`: 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. @@ -19,7 +21,7 @@ */ export type V1TextToVideoCreateBodyModelEnum = | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" diff --git a/src/types/v1-text-to-video-create-body-resolution-enum.ts b/src/types/v1-text-to-video-create-body-resolution-enum.ts index 225829b..07a7414 100644 --- a/src/types/v1-text-to-video-create-body-resolution-enum.ts +++ b/src/types/v1-text-to-video-create-body-resolution-enum.ts @@ -1,9 +1,11 @@ /** * Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * + * * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * * **`kling-2.6`**: Supports 720p, 1080p. * * **`kling-3.0`**: Supports 720p, 1080p, 4k. * * **`ltx-2.3`**: Supports 480p, 720p, 1080p. + * * **`ltx-2.5`**: Supports 480p, 720p, 1080p. * * **`minimax-h3`**: Supports 480p, 720p, 1080p. * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0`**: Supports 480p, 720p. diff --git a/src/types/v1-text-to-video-create-body.ts b/src/types/v1-text-to-video-create-body.ts index 22f580d..2614ded 100644 --- a/src/types/v1-text-to-video-create-body.ts +++ b/src/types/v1-text-to-video-create-body.ts @@ -14,9 +14,11 @@ export type V1TextToVideoCreateBody = { /** * Determines the aspect ratio of the output video. * + * * **`gemini-omni-1.1`**: Supports 16:9, 9:16. * * **`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. + * * **`ltx-2.5`**: 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. @@ -33,9 +35,11 @@ export type V1TextToVideoCreateBody = { * Whether to include audio in the video. Defaults to `false` if not specified. * * Audio support varies by model: + * * **`gemini-omni-1.1`**: Not supported * * **`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 + * * **`ltx-2.5`**: 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 @@ -51,9 +55,11 @@ export type V1TextToVideoCreateBody = { /** * The total duration of the output video in seconds. Supported durations depend on the chosen model: * + * * **`gemini-omni-1.1`**: 3, 4, 5, 6, 7, 8, 9, 10 * * **`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 + * * **`ltx-2.5`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 * * **`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 @@ -70,9 +76,11 @@ 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`. + * * `gemini-omni-1.1`: Best for precise short clips, first/last frames, and high-resolution output. * * `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. + * * `ltx-2.5`: 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. @@ -88,7 +96,7 @@ export type V1TextToVideoCreateBody = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -121,9 +129,11 @@ export type V1TextToVideoCreateBody = { /** * Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * + * * **`gemini-omni-1.1`**: Supports 360p, 720p, 1080p, 4k. * * **`kling-2.6`**: Supports 720p, 1080p. * * **`kling-3.0`**: Supports 720p, 1080p, 4k. * * **`ltx-2.3`**: Supports 480p, 720p, 1080p. + * * **`ltx-2.5`**: Supports 480p, 720p, 1080p. * * **`minimax-h3`**: Supports 480p, 720p, 1080p. * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0`**: Supports 480p, 720p. @@ -151,7 +161,7 @@ export type External$V1TextToVideoCreateBody = { model?: | ( | "default" - | "google-omni-1.1" + | "gemini-omni-1.1" | "kling-1.6" | "kling-2.5" | "kling-2.5-audio" @@ -194,7 +204,7 @@ const SchemaIn$V1TextToVideoCreateBody: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", @@ -250,7 +260,7 @@ const SchemaOut$V1TextToVideoCreateBody: z.ZodType< model: z .enum([ "default", - "google-omni-1.1", + "gemini-omni-1.1", "kling-1.6", "kling-2.5", "kling-2.5-audio", diff --git a/test/v1-ai-video-editor.test.ts b/test/v1-ai-video-editor.test.ts index 802e96f..ef9f67c 100644 --- a/test/v1-ai-video-editor.test.ts +++ b/test/v1-ai-video-editor.test.ts @@ -14,7 +14,7 @@ describe("tests client.v1.aiVideoEditor.create", () => { .create({ assets: { videoFilePath: "api-assets/id/1234.mp4" }, endSeconds: 5.0, - model: "gemini-omni", + model: "gemini-omni-1.1", name: "My Video Editor video", resolution: "720p", startSeconds: 0.0, @@ -24,7 +24,7 @@ describe("tests client.v1.aiVideoEditor.create", () => { client.v1.aiVideoEditor.create({ assets: { videoFilePath: "api-assets/id/1234.mp4" }, endSeconds: 5.0, - model: "gemini-omni", + model: "gemini-omni-1.1", name: "My Video Editor video", resolution: "720p", startSeconds: 0.0,