diff --git a/.sdk.json b/.sdk.json index 98ec4d1..bf729be 100644 --- a/.sdk.json +++ b/.sdk.json @@ -1,5 +1,5 @@ { - "id": "c20a3b55-a5e2-4757-a7f4-0599e8717638", + "id": "1cecda9f-b0c2-4570-9836-723b8349b572", "tracked_paths": [ { "editable": true, diff --git a/src/environment.ts b/src/environment.ts index aaf0a4f..3bff80e 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.73.0", + MockServer = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.74.0", } diff --git a/src/resources/v1/image-to-video/README.md b/src/resources/v1/image-to-video/README.md index ebf96ef..47e34c0 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. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Not supported * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`veo3.1-lite`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`veo3.1`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.0`**: Supports 480p, 720p. * **`sora-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: * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 | `5.0` | -| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`wan-2.2`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.0`**: Toggle-able: no additional credits for audio * **`sora-2`**: Toggle-able: no additional credits for audio | `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`. * `ltx-2.3`: Fastest output. Best for rapid iteration. * `wan-2.2`: Strong physics, camera moves, and motion. * `kling-3.0`: Best overall quality for cinematic storytelling. * `veo3.1-lite`: Veo quality at a more accessible cost. * `veo3.1`: Google's model. Highest realism and detail. * `seedance-1.5`: Smooth, consistent motion with precision. * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * `seedance-2.0`: Top quality with reference-to-video control. * `sora-2`: Open AI's model. Great for creativity and viral clips. If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | -| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Image To Video video"` | -| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`veo3.1`**: Supports 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.0`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. | `"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. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Not supported * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`veo3.1-lite`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`veo3.1`**: Supports 720p, 1080p. Requires a duration of 8 seconds or less. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-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: * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0`**: 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 | `5.0` | +| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`wan-2.2`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.0`**: 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 | `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`. * `ltx-2.3`: Fastest output. Best for rapid iteration. * `wan-2.2`: Strong physics, camera moves, and motion. * `kling-3.0`: Best overall quality for cinematic storytelling. * `veo3.1-lite`: Veo quality at a more accessible cost. * `veo3.1`: Google's model. Highest realism and detail. * `seedance-1.5`: Smooth, consistent motion with precision. * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * `seedance-2.0`: Top quality with reference-to-video control. * `seedance-2.5`: Highest quality with superior realism, detail, and motion * `sora-2`: Open AI's model. Great for creativity and viral clips. If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | +| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Image To Video video"` | +| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`veo3.1`**: Supports 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. | `"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 29fbb9a..09295c5 100644 --- a/src/resources/v1/image-to-video/request-types.ts +++ b/src/resources/v1/image-to-video/request-types.ts @@ -32,6 +32,7 @@ export type CreateRequest = { * * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * * **`seedance-2.0`**: 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 * */ @@ -47,6 +48,7 @@ export type CreateRequest = { * * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * * **`seedance-2.0`**: 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 * */ @@ -69,6 +71,7 @@ export type CreateRequest = { * * `seedance-1.5`: Smooth, consistent motion with precision. * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * * `seedance-2.0`: Top quality with reference-to-video control. + * * `seedance-2.5`: Highest quality with superior realism, detail, and motion * * `sora-2`: Open AI's model. Great for creativity and viral clips. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. @@ -86,6 +89,7 @@ export type CreateRequest = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -108,6 +112,7 @@ export type CreateRequest = { * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0-mini`**: Supports 480p, 720p. * * **`seedance-2.0`**: Supports 480p, 720p. + * * **`seedance-2.5`**: Supports 480p, 720p. * * **`sora-2`**: Supports 720p. * */ @@ -147,6 +152,7 @@ export type External$CreateRequest = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -186,6 +192,7 @@ const SchemaIn$CreateRequest: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-audio", @@ -239,6 +246,7 @@ const SchemaOut$CreateRequest: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-audio", diff --git a/src/resources/v1/text-to-video/README.md b/src/resources/v1/text-to-video/README.md index 4b29e34..c6da0fd 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: * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`sora-2`**: 4, 8, 12, 24, 36, 48, 60 | `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. * **`ltx-2.3`**: Supports 9:16, 16:9, 1:1. * **`wan-2.2`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`veo3.1-lite`**: Supports 9:16, 16:9. * **`veo3.1`**: Supports 9:16, 16:9. * **`seedance-1.5`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`sora-2`**: Supports 9:16, 16:9. | `"16:9"` | -| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`wan-2.2`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.0`**: Toggle-able: no additional credits for audio * **`sora-2`**: Toggle-able: no additional credits for audio | `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`. * `ltx-2.3`: Fastest output. Best for rapid iteration. * `wan-2.2`: Strong physics, camera moves, and motion. * `kling-3.0`: Best overall quality for cinematic storytelling. * `veo3.1-lite`: Veo quality at a more accessible cost. * `veo3.1`: Google's model. Highest realism and detail. * `seedance-1.5`: Smooth, consistent motion with precision. * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * `seedance-2.0`: Top quality with reference-to-video control. * `sora-2`: Open AI's model. Great for creativity and viral clips. If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | -| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Text To Video video"` | -| `orientation` | ✗ | ✓ | Deprecated. Use `aspect_ratio` instead. | `"landscape"` | -| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`veo3.1`**: Supports 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.0`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. | `"720p"` | +| Parameter | Required | Deprecated | Description | Example | +| ---------------- | :------: | :--------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | +| `endSeconds` | ✓ | ✗ | The total duration of the output video in seconds. Supported durations depend on the chosen model: * **`ltx-2.3`**: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30 * **`wan-2.2`**: 3, 4, 5, 6, 7, 8, 9, 10, 15 * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`veo3.1-lite`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`veo3.1`**: 4, 6, 8, 16, 24, 32, 40, 48, 56 * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * **`seedance-2.0`**: 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 | `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. * **`ltx-2.3`**: Supports 9:16, 16:9, 1:1. * **`wan-2.2`**: Supports 9:16, 16:9, 1:1. * **`kling-3.0`**: Supports 9:16, 16:9, 1:1. * **`veo3.1-lite`**: Supports 9:16, 16:9. * **`veo3.1`**: Supports 9:16, 16:9. * **`seedance-1.5`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. * **`seedance-2.5`**: Supports 9:16, 16:9, 1:1. * **`sora-2`**: Supports 9:16, 16:9. | `"16:9"` | +| `audio` | ✗ | ✗ | Whether to include audio in the video. Defaults to `false` if not specified. Audio support varies by model: * **`ltx-2.3`**: Toggle-able: no additional credits for audio * **`wan-2.2`**: Not supported * **`kling-3.0`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1-lite`**: Toggle-able: audio adds extra credits when enabled * **`veo3.1`**: Toggle-able: audio adds extra credits when enabled * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * **`seedance-2.0`**: 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 | `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`. * `ltx-2.3`: Fastest output. Best for rapid iteration. * `wan-2.2`: Strong physics, camera moves, and motion. * `kling-3.0`: Best overall quality for cinematic storytelling. * `veo3.1-lite`: Veo quality at a more accessible cost. * `veo3.1`: Google's model. Highest realism and detail. * `seedance-1.5`: Smooth, consistent motion with precision. * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * `seedance-2.0`: Top quality with reference-to-video control. * `seedance-2.5`: Highest quality with superior realism, detail, and motion * `sora-2`: Open AI's model. Great for creativity and viral clips. If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. | `"kling-3.0"` | +| `name` | ✗ | ✗ | Give your video a custom name for easy identification. | `"My Text To Video video"` | +| `orientation` | ✗ | ✓ | Deprecated. Use `aspect_ratio` instead. | `"landscape"` | +| `resolution` | ✗ | ✗ | Controls the output video resolution. Defaults to `720p` on paid tiers and `480p` on free tiers. * **`ltx-2.3`**: Supports 480p, 720p, 1080p. * **`wan-2.2`**: Supports 480p, 720p, 1080p. * **`kling-3.0`**: Supports 720p, 1080p, 4k. * **`veo3.1-lite`**: Supports 720p, 1080p. * **`veo3.1`**: Supports 720p, 1080p. * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * **`seedance-2.0-mini`**: Supports 480p, 720p. * **`seedance-2.0`**: Supports 480p, 720p. * **`seedance-2.5`**: Supports 480p, 720p. * **`sora-2`**: Supports 720p. | `"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 621ad58..497749b 100644 --- a/src/resources/v1/text-to-video/request-types.ts +++ b/src/resources/v1/text-to-video/request-types.ts @@ -22,6 +22,7 @@ export type CreateRequest = { * * **`seedance-1.5`**: Supports 9:16, 16:9, 1:1. * * **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1. * * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. + * * **`seedance-2.5`**: Supports 9:16, 16:9, 1:1. * * **`sora-2`**: Supports 9:16, 16:9. * */ @@ -38,6 +39,7 @@ export type CreateRequest = { * * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * * **`seedance-2.0`**: 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 * */ @@ -53,6 +55,7 @@ export type CreateRequest = { * * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * * **`seedance-2.0`**: 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 * */ @@ -69,6 +72,7 @@ export type CreateRequest = { * * `seedance-1.5`: Smooth, consistent motion with precision. * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * * `seedance-2.0`: Top quality with reference-to-video control. + * * `seedance-2.5`: Highest quality with superior realism, detail, and motion * * `sora-2`: Open AI's model. Great for creativity and viral clips. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. @@ -86,6 +90,7 @@ export type CreateRequest = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -112,6 +117,7 @@ export type CreateRequest = { * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0-mini`**: Supports 480p, 720p. * * **`seedance-2.0`**: Supports 480p, 720p. + * * **`seedance-2.5`**: Supports 480p, 720p. * * **`sora-2`**: Supports 720p. * */ @@ -141,6 +147,7 @@ export type External$CreateRequest = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -179,6 +186,7 @@ const SchemaIn$CreateRequest: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-audio", @@ -230,6 +238,7 @@ const SchemaOut$CreateRequest: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-audio", diff --git a/src/types/v1-image-projects-get-response.ts b/src/types/v1-image-projects-get-response.ts index 21c1bee..64ef2ea 100644 --- a/src/types/v1-image-projects-get-response.ts +++ b/src/types/v1-image-projects-get-response.ts @@ -53,7 +53,7 @@ export type V1ImageProjectsGetResponse = { */ totalFrameCost: number; /** - * The type of the image project. Possible values are FACE_EDITOR, AI_IMAGE_EDITOR, AI_SELFIE, AI_HEADSHOT, AI_INFLUENCER, AI_IMAGE, AI_MEME, CLOTHES_CHANGER, BACKGROUND_REMOVER, FACE_SWAP, IMAGE_UPSCALER, AI_GIF, QR_CODE, PHOTO_EDITOR, PHOTO_COLORIZER, HEAD_SWAP, BODY_SWAP, STORYBOARD, IMAGE_EXPANDER + * The type of the image project. Possible values are FACE_EDITOR, AI_IMAGE_EDITOR, AI_SELFIE, AI_HEADSHOT, AI_INFLUENCER, AI_IMAGE, AI_MEME, CLOTHES_CHANGER, BACKGROUND_REMOVER, FACE_SWAP, IMAGE_UPSCALER, IMAGE_ENHANCER, AI_GIF, QR_CODE, PHOTO_EDITOR, PHOTO_COLORIZER, HEAD_SWAP, BODY_SWAP, STORYBOARD, IMAGE_EXPANDER */ type: string; }; 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 1ef1f23..79a908f 100644 --- a/src/types/v1-image-to-video-create-body-assets.ts +++ b/src/types/v1-image-to-video-create-body-assets.ts @@ -16,6 +16,7 @@ export type V1ImageToVideoCreateBodyAssets = { * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0-mini`**: Supports 480p, 720p. * * **`seedance-2.0`**: Supports 480p, 720p. + * * **`seedance-2.5`**: Supports 480p, 720p. * * **`sora-2`**: Not supported * */ 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 04e70c6..907ed1a 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 @@ -10,6 +10,7 @@ * * `seedance-1.5`: Smooth, consistent motion with precision. * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * * `seedance-2.0`: Top quality with reference-to-video control. + * * `seedance-2.5`: Highest quality with superior realism, detail, and motion * * `sora-2`: Open AI's model. Great for creativity and viral clips. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. @@ -26,6 +27,7 @@ export type V1ImageToVideoCreateBodyModelEnum = | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-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 bd22b43..ffc84ee 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 @@ -9,6 +9,7 @@ * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0-mini`**: Supports 480p, 720p. * * **`seedance-2.0`**: Supports 480p, 720p. + * * **`seedance-2.5`**: Supports 480p, 720p. * * **`sora-2`**: Supports 720p. * */ diff --git a/src/types/v1-image-to-video-create-body.ts b/src/types/v1-image-to-video-create-body.ts index 92e7242..7b57807 100644 --- a/src/types/v1-image-to-video-create-body.ts +++ b/src/types/v1-image-to-video-create-body.ts @@ -32,6 +32,7 @@ export type V1ImageToVideoCreateBody = { * * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * * **`seedance-2.0`**: 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 * */ @@ -47,6 +48,7 @@ export type V1ImageToVideoCreateBody = { * * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * * **`seedance-2.0`**: 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 * */ @@ -69,6 +71,7 @@ export type V1ImageToVideoCreateBody = { * * `seedance-1.5`: Smooth, consistent motion with precision. * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * * `seedance-2.0`: Top quality with reference-to-video control. + * * `seedance-2.5`: Highest quality with superior realism, detail, and motion * * `sora-2`: Open AI's model. Great for creativity and viral clips. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. @@ -86,6 +89,7 @@ export type V1ImageToVideoCreateBody = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -108,6 +112,7 @@ export type V1ImageToVideoCreateBody = { * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0-mini`**: Supports 480p, 720p. * * **`seedance-2.0`**: Supports 480p, 720p. + * * **`seedance-2.5`**: Supports 480p, 720p. * * **`sora-2`**: Supports 720p. * */ @@ -147,6 +152,7 @@ export type External$V1ImageToVideoCreateBody = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -186,6 +192,7 @@ const SchemaIn$V1ImageToVideoCreateBody: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-audio", @@ -239,6 +246,7 @@ const SchemaOut$V1ImageToVideoCreateBody: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-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 df5b43e..a02bfcb 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 @@ -9,6 +9,7 @@ * * **`seedance-1.5`**: Supports 9:16, 16:9, 1:1. * * **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1. * * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. + * * **`seedance-2.5`**: Supports 9:16, 16:9, 1:1. * * **`sora-2`**: Supports 9:16, 16:9. * */ 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 66fb0ed..072605d 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 @@ -10,6 +10,7 @@ * * `seedance-1.5`: Smooth, consistent motion with precision. * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * * `seedance-2.0`: Top quality with reference-to-video control. + * * `seedance-2.5`: Highest quality with superior realism, detail, and motion * * `sora-2`: Open AI's model. Great for creativity and viral clips. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. @@ -26,6 +27,7 @@ export type V1TextToVideoCreateBodyModelEnum = | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-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 45ad49f..059039d 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 @@ -9,6 +9,7 @@ * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0-mini`**: Supports 480p, 720p. * * **`seedance-2.0`**: Supports 480p, 720p. + * * **`seedance-2.5`**: Supports 480p, 720p. * * **`sora-2`**: Supports 720p. * */ diff --git a/src/types/v1-text-to-video-create-body.ts b/src/types/v1-text-to-video-create-body.ts index 72c68ab..eff9931 100644 --- a/src/types/v1-text-to-video-create-body.ts +++ b/src/types/v1-text-to-video-create-body.ts @@ -22,6 +22,7 @@ export type V1TextToVideoCreateBody = { * * **`seedance-1.5`**: Supports 9:16, 16:9, 1:1. * * **`seedance-2.0-mini`**: Supports 9:16, 16:9, 1:1. * * **`seedance-2.0`**: Supports 9:16, 16:9, 1:1. + * * **`seedance-2.5`**: Supports 9:16, 16:9, 1:1. * * **`sora-2`**: Supports 9:16, 16:9. * */ @@ -38,6 +39,7 @@ export type V1TextToVideoCreateBody = { * * **`seedance-1.5`**: Toggle-able: audio adds extra credits when enabled * * **`seedance-2.0-mini`**: Toggle-able: no additional credits for audio * * **`seedance-2.0`**: 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 * */ @@ -53,6 +55,7 @@ export type V1TextToVideoCreateBody = { * * **`seedance-1.5`**: 4, 5, 6, 7, 8, 9, 10, 11, 12 * * **`seedance-2.0-mini`**: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 * * **`seedance-2.0`**: 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 * */ @@ -69,6 +72,7 @@ export type V1TextToVideoCreateBody = { * * `seedance-1.5`: Smooth, consistent motion with precision. * * `seedance-2.0-mini`: Fast, consistent video with strong motion quality * * `seedance-2.0`: Top quality with reference-to-video control. + * * `seedance-2.5`: Highest quality with superior realism, detail, and motion * * `sora-2`: Open AI's model. Great for creativity and viral clips. * * If you specify the deprecated model value that includes the `-audio` suffix, this will be the same as included `audio` as `true`. @@ -86,6 +90,7 @@ export type V1TextToVideoCreateBody = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -112,6 +117,7 @@ export type V1TextToVideoCreateBody = { * * **`seedance-1.5`**: Supports 480p, 720p, 1080p. * * **`seedance-2.0-mini`**: Supports 480p, 720p. * * **`seedance-2.0`**: Supports 480p, 720p. + * * **`seedance-2.5`**: Supports 480p, 720p. * * **`sora-2`**: Supports 720p. * */ @@ -141,6 +147,7 @@ export type External$V1TextToVideoCreateBody = { | "seedance-1.5" | "seedance-2.0" | "seedance-2.0-mini" + | "seedance-2.5" | "sora-2" | "veo3.1" | "veo3.1-audio" @@ -179,6 +186,7 @@ const SchemaIn$V1TextToVideoCreateBody: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-audio", @@ -230,6 +238,7 @@ const SchemaOut$V1TextToVideoCreateBody: z.ZodType< "seedance-1.5", "seedance-2.0", "seedance-2.0-mini", + "seedance-2.5", "sora-2", "veo3.1", "veo3.1-audio",