Input

Clients provide a link to the input video or a reference to an event or job ID. The ID or link can either point directly to a media file (e.g. ending with .mp4) or to a social media share link, e.g. a Tweet or a YouTube video.

Params

`language`

Specifies the output language of the video. Input language is auto-detected.

[ "param", "language", "es"]

`subtitle`

Optional parameter. Specifies the language for subtitle captions that be burned into the video.

[ "param", "subtitle", "en"]

`range`

Optional parameter. Specifies a range if the video translation should be targeted to a specific timestamp range.

[ "param", "range", "<start>", "<end>" ]

`format`

Optional. If set the DVM uses the format to convert the video to the given format, otherwise it’s up to the DVM to choose an output format. By using a format such as mp3, the video might also be converted to an audio file.

[ "output", "video/mp4" ]

Output

A link to the translated video.

Example

Generates the output based on the input link and params

{
    "content": "",
    "kind": 5201,
    "tags": [
        [ "i", "https://video.nostr.build/401b8475dc5aa523b2edc7fbeb462f09f168aac8f268a598ac3556aca279c7fa.mp4", "url" ],
        [ "i", "<hexid>", "event" ],
        [ "i", "<hexid>", "job" ],
        [ "param", "language", "es"],
        [ "param", "subtitle", "en"]
    ]
}

Appendix A

Langue codes SHOULD be on ISO 639-2/ISO 639-1

Video Translation