Jevrouter Video API · video-to-video

subtitles

veed/subtitles:video

VEED Subtitles burns styled subtitles into an input video using automatic transcription or a supplied SRT file/content.

Options and pricing

Task: video-to-video. Catalog base price: $0.11. The exact quote depends on your inputs; the catalog price is not a fixed per-task charge.

We reserve the quoted maximum before submission, settle the actual generation cost and release the remainder. Set jev.max_cost_usd to your maximum reservation. A quote above this limit is rejected before generation.

Input field	Type	Required	Options / default
`file`	string	No	See schema
`video`	string	Yes	See schema
`preset`	string	No	["simple","plain","glass","whisper","glide2","fusion","glide","terminal","handwritten","backdrop","backdrop2","beans","corpo","boo","shadeplay","casper","capri","lowkey","vinta","diego","ali","slay","kitty","hustle","karl","sprout","flex","mint","rizz","vegas"]
`shadow`	string	No	["none","min","mid","max"]
`language`	string	No	["af-ZA","am-ET","ar-AE","ar-BH","ar-DZ","ar-EG","ar-IL","ar-IQ","ar-JO","ar-KW","ar-LB","ar-MA","ar-MR","ar-OM","ar-PS","ar-QA","ar-SA","ar-TN","ar-YE","az-AZ","bg-BG","bn-BD","bn-IN","bs-BA","ca-ES","cs-CZ","cy-GB","da-DK","de-AT","de-CH","de-DE","el-GR","en-AU","en-CA","en-GB","en-GH","en-HK","en-IE","en-IN","en-KE","en-NG","en-NZ","en-PH","en-PK","en-SG","en-TZ","en-US","en-ZA","es-AR","es-BO","es-CL","es-CO","es-CR","es-CU","es-DO","es-EC","es-ES","es-GQ","es-GT","es-HN","es-MX","es-NI","es-PA","es-PE","es-PR","es-PY","es-SV","es-US","es-UY","es-VE","et-EE","eu-ES","fa-IR","fi-FI","fil-PH","fr-BE","fr-CA","fr-CH","fr-FR","gl-ES","gu-IN","he-IL","hi-IN","hr-HR","hu-HU","hy-AM","id-ID","is-IS","it-CH","it-IT","ja-JP","jv-ID","ka-GE","kk-KZ","km-KH","kn-IN","ko-KR","lo-LA","lt-LT","lv-LV","mk-MK","ml-IN","mn-MN","mr-IN","ms-MY","my-MM","ne-NP","nl-BE","nl-NL","no-NO","pa-Guru-IN","pl-PL","ps-AF","pt-BR","pt-PT","ro-RO","ru-RU","si-LK","sk-SK","sl-SI","so-SO","sq-AL","sr-RS","su-ID","sv-SE","sw-KE","sw-TZ","ta-IN","ta-LK","ta-MY","ta-SG","te-IN","th-TH","tr-TR","uk-UA","ur-IN","ur-PK","uz-UZ","vi-VN","zh-CN","zh-HK","zh-TW","zu-ZA"]
`position`	string	No	["top","center","bottom"]
`srt_content`	string	No	See schema
`target_resolution`	string	No	["480p","720p","1080p"]

Complete input schema

{
  "type": "object",
  "required": [
    "video"
  ],
  "properties": {
    "file": {
      "type": "string",
      "x-accept": ".srt,text/plain",
      "description": "Optional SRT subtitle file. Do not use together with srt_content.",
      "x-ui-component": "uploader"
    },
    "video": {
      "type": "string",
      "description": "Input video URL."
    },
    "preset": {
      "enum": [
        "simple",
        "plain",
        "glass",
        "whisper",
        "glide2",
        "fusion",
        "glide",
        "terminal",
        "handwritten",
        "backdrop",
        "backdrop2",
        "beans",
        "corpo",
        "boo",
        "shadeplay",
        "casper",
        "capri",
        "lowkey",
        "vinta",
        "diego",
        "ali",
        "slay",
        "kitty",
        "hustle",
        "karl",
        "sprout",
        "flex",
        "mint",
        "rizz",
        "vegas"
      ],
      "type": "string",
      "default": "simple",
      "description": "Subtitle visual preset.",
      "x-ui-component": "select"
    },
    "shadow": {
      "enum": [
        "none",
        "min",
        "mid",
        "max"
      ],
      "type": "string",
      "default": "mid",
      "description": "Text shadow strength.",
      "x-ui-component": "select"
    },
    "language": {
      "enum": [
        "af-ZA",
        "am-ET",
        "ar-AE",
        "ar-BH",
        "ar-DZ",
        "ar-EG",
        "ar-IL",
        "ar-IQ",
        "ar-JO",
        "ar-KW",
        "ar-LB",
        "ar-MA",
        "ar-MR",
        "ar-OM",
        "ar-PS",
        "ar-QA",
        "ar-SA",
        "ar-TN",
        "ar-YE",
        "az-AZ",
        "bg-BG",
        "bn-BD",
        "bn-IN",
        "bs-BA",
        "ca-ES",
        "cs-CZ",
        "cy-GB",
        "da-DK",
        "de-AT",
        "de-CH",
        "de-DE",
        "el-GR",
        "en-AU",
        "en-CA",
        "en-GB",
        "en-GH",
        "en-HK",
        "en-IE",
        "en-IN",
        "en-KE",
        "en-NG",
        "en-NZ",
        "en-PH",
        "en-PK",
        "en-SG",
        "en-TZ",
        "en-US",
        "en-ZA",
        "es-AR",
        "es-BO",
        "es-CL",
        "es-CO",
        "es-CR",
        "es-CU",
        "es-DO",
        "es-EC",
        "es-ES",
        "es-GQ",
        "es-GT",
        "es-HN",
        "es-MX",
        "es-NI",
        "es-PA",
        "es-PE",
        "es-PR",
        "es-PY",
        "es-SV",
        "es-US",
        "es-UY",
        "es-VE",
        "et-EE",
        "eu-ES",
        "fa-IR",
        "fi-FI",
        "fil-PH",
        "fr-BE",
        "fr-CA",
        "fr-CH",
        "fr-FR",
        "gl-ES",
        "gu-IN",
        "he-IL",
        "hi-IN",
        "hr-HR",
        "hu-HU",
        "hy-AM",
        "id-ID",
        "is-IS",
        "it-CH",
        "it-IT",
        "ja-JP",
        "jv-ID",
        "ka-GE",
        "kk-KZ",
        "km-KH",
        "kn-IN",
        "ko-KR",
        "lo-LA",
        "lt-LT",
        "lv-LV",
        "mk-MK",
        "ml-IN",
        "mn-MN",
        "mr-IN",
        "ms-MY",
        "my-MM",
        "ne-NP",
        "nl-BE",
        "nl-NL",
        "no-NO",
        "pa-Guru-IN",
        "pl-PL",
        "ps-AF",
        "pt-BR",
        "pt-PT",
        "ro-RO",
        "ru-RU",
        "si-LK",
        "sk-SK",
        "sl-SI",
        "so-SO",
        "sq-AL",
        "sr-RS",
        "su-ID",
        "sv-SE",
        "sw-KE",
        "sw-TZ",
        "ta-IN",
        "ta-LK",
        "ta-MY",
        "ta-SG",
        "te-IN",
        "th-TH",
        "tr-TR",
        "uk-UA",
        "ur-IN",
        "ur-PK",
        "uz-UZ",
        "vi-VN",
        "zh-CN",
        "zh-HK",
        "zh-TW",
        "zu-ZA"
      ],
      "type": "string",
      "description": "Optional transcription language locale, such as en-US or zh-CN. Leave empty to auto-detect.",
      "x-ui-component": "select"
    },
    "position": {
      "enum": [
        "top",
        "center",
        "bottom"
      ],
      "type": "string",
      "default": "bottom",
      "description": "Subtitle position.",
      "x-ui-component": "select"
    },
    "srt_content": {
      "type": "string",
      "x-rows": 6,
      "description": "Optional raw SRT subtitle content. Do not use together with file.",
      "x-ui-component": "textarea"
    },
    "target_resolution": {
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "default": "720p",
      "description": "Maximum resolution box used before subtitle generation.",
      "x-ui-component": "select"
    }
  },
  "x-order-properties": [
    "video",
    "target_resolution",
    "preset",
    "position",
    "shadow",
    "language",
    "file",
    "srt_content"
  ],
  "additionalProperties": false
}

Required fields and conditional rules come from the published schema. Catalog support does not mean every option has been independently tested by Jevrouter. Synchronous generation, base64 output and customer callbacks are unavailable.

1. Submit a video task

Allow this model on your Jevrouter key. Replace every placeholder below with a value of the correct type, set a USD limit, and supply any conditional fields required by the schema. Media inputs must use your own accessible URLs; this endpoint does not upload files.

curl https://api.jevrouter.io/v1/videos \
  -H "Authorization: Bearer $JEVROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-demo-001" \
  -d @- <<'JSON'
{
  "model": "veed/subtitles:video",
  "input": {
    "video": "<video: provide string>",
    "preset": "simple",
    "shadow": "mid",
    "position": "bottom",
    "target_resolution": "720p"
  },
  "jev": {
    "max_cost_usd": "YOUR_USD_LIMIT"
  }
}
JSON

Save data.id and data.urls.get. An accepted task continues even if you disconnect.

Let Jevrouter choose

Use jev/auto as the model and set task to video-to-video. Your project must enable Auto, and both the project and key must allow Auto and the candidate models.

Auto checks the task type and all supplied input fields against each candidate. It compares live quotes for up to eight compatible candidates, shortlisted by catalog base price. It selects the lowest quote within that shortlist and your budget; this is not a quality ranking or a guarantee of the cheapest model in the entire catalog.

Use common options such as duration, resolution and aspect_ratio at the top level where available. Model-specific options belong in input and may narrow the pool. Unsupported options are rejected, never silently dropped. Without task, Auto defaults to text-to-video.

2. Check the result

curl https://api.jevrouter.io/v1/videos/REQUEST_ID \
  -H "Authorization: Bearer $JEVROUTER_API_KEY"

Replace REQUEST_ID with your task ID. Wait at least three seconds between checks. Status progresses from queued to processing, then completed or failed. Results appear in data.outputs as media URLs or structured output objects.

If the submission response is lost, repeat the original request with the same idempotency key. A new key may create another billed task.

Results and billing

View the request in your dashboard or query /v1/requests/REQUEST_ID for reservation and settlement details. Results may be ready before the bill arrives.

Result links are retained for up to seven days and may expire earlier. Save your video while it is available. Anyone with a media URL may be able to access it. Cancellation and customer webhooks are not available.

Build the complete flow

Python example: generate, resume and download Video API contract and errors