MediaTransforms.cs

using ServiceStack;
using ServiceStack.DataAnnotations;

namespace AiServer.ServiceModel;

[ValidateApiKey]
[Tag(Tags.Media)]
[Api("Scale video")]
[Notes("Scale a video to specified dimensions")]
public class ScaleVideo : IMediaTransform, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The video file to be scaled")]
    [Required]
    [Input(Type = "file")]
    public string? Video { get; set; }

    [ApiMember(Description = "Desired width of the scaled video")]
    [Range(1, 7680)]  // Assuming 8K as max resolution
    public int? Width { get; set; }

    [ApiMember(Description = "Desired height of the scaled video")]
    [Range(1, 4320)]  // Assuming 8K as max resolution
    public int? Height { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[ValidateApiKey]
[Tag(Tags.Media)]
[Api("Watermark video")]
[Notes("Add a watermark to a video")]
public class WatermarkVideo : IMediaTransform, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The video file to be watermarked")]
    [Required]
    [Input(Type = "file")]
    public string? Video { get; set; }
 
    [ApiMember(Description = "The image file to use as a watermark")]
    [Required]
    [Input(Type = "file")]
    public string? Watermark { get; set; }
    
    [ApiMember(Description = "Position of the watermark")]
    public WatermarkPosition? Position { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

public enum WatermarkPosition
{
    TopLeft,
    TopRight,
    BottomLeft,
    BottomRight,
    Center,
}


[Api("Convert an image to a different format")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class ConvertImage : IMediaTransform, IPost, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The image file to be converted")]
    [Required]
    [Input(Type = "file")]
    public string? Image { get; set; }

    [ApiMember(Description = "The desired output format for the converted image")]
    [Required]
    public ImageOutputFormat? OutputFormat { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[Api("Crop an image to a specified area")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class CropImage : IMediaTransform, IPost, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The X-coordinate of the top-left corner of the crop area")]
    public int X { get; set; }

    [ApiMember(Description = "The Y-coordinate of the top-left corner of the crop area")]
    public int Y { get; set; }

    [ApiMember(Description = "The width of the crop area")]
    public int Width { get; set; }

    [ApiMember(Description = "The height of the crop area")]
    public int Height { get; set; }
    
    [ApiMember(Description = "The image file to be cropped")]
    [Required]
    [Input(Type = "file")]
    public string? Image { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[Api("Scale an image to a specified size")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class ScaleImage : IMediaTransform, IPost, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The image file to be scaled")]
    [Required]
    [Input(Type = "file")]
    public string? Image { get; set; }
    
    [ApiMember(Description = "Desired width of the scaled image")]
    public int? Width { get; set; }
    
    [ApiMember(Description = "Desired height of the scaled image")]
    public int? Height { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[Api("Add a watermark to an image")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class WatermarkImage : IMediaTransform, IPost, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The image file to be watermarked")]
    [Required]
    [Input(Type = "file")]
    public string? Image { get; set; }

    [ApiMember(Description = "The position of the watermark on the image")]
    public WatermarkPosition Position { get; set; }
    
    [ApiMember(Description = "Scale of the watermark relative")]
    public float WatermarkScale { get; set; } = 1.0f;

    [ApiMember(Description = "The opacity of the watermark (0.0 to 1.0)")]
    public float Opacity { get; set; } = 0.5f;
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[Api("Convert a video to a different format")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class ConvertVideo : IMediaTransform, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The desired output format for the converted video")]
    [Required]
    public ConvertVideoOutputFormat OutputFormat { get; set; }
    
    [Required]
    [Input(Type = "file")]
    public string? Video { get; set; }

    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[Api("Crop a video to a specified area")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class CropVideo : IMediaTransform, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The X-coordinate of the top-left corner of the crop area")]
    [ValidateGreaterThan(0)]
    [Required]
    public int X { get; set; }

    [ApiMember(Description = "The Y-coordinate of the top-left corner of the crop area")]
    [ValidateGreaterThan(0)]
    [Required]
    public int Y { get; set; }

    [ApiMember(Description = "The width of the crop area")]
    [ValidateGreaterThan(0)]
    [Required]
    public int Width { get; set; }

    [ApiMember(Description = "The height of the crop area")]
    [ValidateGreaterThan(0)]
    [Required]
    public int Height { get; set; }
    
    [Required]
    [Input(Type = "file")]
    public string? Video { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[Api("Trim a video to a specified duration via start and end times")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class TrimVideo : IMediaTransform, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The start time of the trimmed video (format: MM:SS)")]
    [Required]
    public string StartTime { get; set; }

    [ApiMember(Description = "The end time of the trimmed video (format: MM:SS)")]
    public string? EndTime { get; set; }
    
    [Required]
    [Input(Type = "file")]
    public string? Video { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

[Api("Convert an audio file to a different format")]
[Tag(Tags.Media)]
[ValidateApiKey]
public class ConvertAudio : IMediaTransform, IReturn<ArtifactGenerationResponse>
{
    [ApiMember(Description = "The desired output format for the converted audio")]
    [Required]
    public AudioFormat OutputFormat { get; set; }
    
    [Required]
    [Input(Type = "file")]
    public string? Audio { get; set; }
    
    [ApiMember(Description = "Optional client-provided identifier for the request")]
    public string? RefId { get; set; }
    
    [ApiMember(Description = "Tag to identify the request")]
    public string? Tag { get; set; }
}

public interface IMediaTransform
{
    public string? RefId { get; set; }
    public string? Tag { get; set; }
}