magic_hour 0.61.0

Magic Hour Rust SDK
Documentation
/// V1TextToVideoCreateBody
#[derive(serde::Serialize, serde::Deserialize, Debug, Default, Clone)]
pub struct V1TextToVideoCreateBody {
    /// 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-2.5`**: 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.
    ///
    #[serde(skip_serializing_if = "Option::is_none")]
    pub aspect_ratio: Option<crate::models::V1TextToVideoCreateBodyAspectRatioEnum>,
    /// 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-2.5`**: Toggle-able: no additional credits for audio
    /// * **`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
    ///
    #[serde(skip_serializing_if = "Option::is_none")]
    pub audio: Option<bool>,
    /// 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-2.5`**: 5, 10
    /// * **`kling-3.0`**: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
    /// * **`veo3.1-lite`**: 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
    ///
    pub end_seconds: f64,
    /// 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-2.5`: Great for action, motion blur, and camera moves.
    /// * `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`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub model: Option<crate::models::V1TextToVideoCreateBodyModelEnum>,
    /// Give your video a custom name for easy identification.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// Deprecated. Use `aspect_ratio` instead.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub orientation: Option<crate::models::V1TextToVideoCreateBodyOrientationEnum>,
    /// 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-2.5`**: Supports 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.
    ///
    #[serde(skip_serializing_if = "Option::is_none")]
    pub resolution: Option<crate::models::V1TextToVideoCreateBodyResolutionEnum>,
    pub style: crate::models::V1TextToVideoCreateBodyStyle,
}