# Subtitles API

> Ενσωματώνει μορφοποιημένους υπότιτλους σε βίντεο, από αυτόματη απομαγνητοφώνηση ή δικό σας SRT, με προαιρετική μετάφραση

Προσθέτει αποδομένους υπότιτλους σε βίντεο (`video_url`) χρησιμοποιώντας υποχρεωτικό στυλ `preset`, με διαθέσιμες 30 προεπιλογές. Απομαγνητοφωνεί αυτόματα ή παραλείπει αυτό το βήμα αν δώσετε `srt_file_url` ή `srt_content`. Το `language` ορίζει τη γλώσσα πηγής για ακρίβεια και το `translation_language` μεταφράζει τους υπότιτλους. Μια λίστα `vocabulary` έως 100 όρων και οι παρακάμψεις `customization` βελτιώνουν περαιτέρω το αποτέλεσμα.

- Model id: `veed/subtitles`
- Made by: VEED
- Category: Video to Video
- Output: video
- Price per minute of your input video: from $0.10 / minute of input video (cheapest run $0.10 (100 API credits))
- Run: `POST https://api.doitong.com/v1/run/veed/subtitles`
- Quote: `POST https://api.doitong.com/v1/quote/veed/subtitles`
- Docs page: https://doitong.com/el/developers/models/veed/subtitles

## Pricing

Price: **from $0.10 / minute of input video** (the lowest tier; the quote prices your exact input). Price per minute of your input video: the input files are measured before the run (length, resolution, frame rate). The quote measures the same files and is exactly what the run charges.

Price by tier:

- base rate: $0.10 / minute of input video
- above 1080p: $0.20 / minute of input video

The full example input below costs $0.20 = 200 API credits (1 min input video × $0.20).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/veed/subtitles` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `video_url` | `video` | string (video URL) | yes |  | 1 – 2083 characters | Βίντεο πηγής για υποτιτλισμό· μεταφορτώστε το αρχείο ή επικολλήστε το URL του. |
| `preset` |  | enum (string) | yes |  | `glass`, `whisper`, `glide2`, `fusion`, `glide`, `terminal`, `handwritten`, `backdrop`, `backdrop2`, `simple`, `plain`, `beans`, `corpo`, `boo`, `shadeplay`, `casper`, `capri`, `lowkey`, `vinta`, `diego`, `ali`, `slay`, `kitty`, `hustle`, `karl`, `sprout`, `flex`, `mint`, `rizz`, `vegas` | Επιλογή στυλ που καθορίζει τυπογραφία, χρώμα, διάταξη και animation, με πλουσιότερη απόδοση που ανταποκρίνεται στο πλαίσιο της εισόδου. Οι βασικές προεπιλογές χρησιμοποιούν πολλαπλασιαστή 1 και παρέχουν προβλέψιμα αποτελέσματα μέσω σταθερού, ελαφριού στυλ: vegas, rizz, mint, flex, sprout, karl, hustle, kitty, slay, ali, diego, vinta, lowkey, capri, casper, shadeplay, boo, corpo, beans, plain, simple. |
| `language` |  | enum (string) \| null | 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-OM`, `ar-PS`, `ar-QA`, `ar-SA`, `ar-TN`, `ast-ES`, `az-AZ`, `ba`, `bas`, `be-BY`, `bg-BG`, `br`, `bs-BA`, `ca-ES`, `ceb-PH`, `ckb-IQ`, `cs-CZ`, `cy-GB`, `da-DK`, `de-DE`, `dyu`, `el-GR`, `en-AU`, `en-GB`, `en-IN`, `en-NZ`, `en-US`, `eo`, `es-AR`, `es-BO`, `es-CL`, `es-CO`, `es-CR`, `es-DO`, `es-EC`, `es-ES`, `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`, `ff`, `fi-FI`, `fil-PH`, `fo`, `fr-CA`, `fr-FR`, `fy`, `ga`, `gd`, `gl-ES`, `ha-NG`, `haw`, `he-IL`, `hr-HR`, `hsb`, `ht`, `hu-HU`, `hy-AM`, `id-ID`, `ig`, `is-IS`, `it-IT`, `ja-JP`, `ja-Latn-JP`, `jv-ID`, `ka-GE`, `kab`, `kam-KE`, `kea-CV`, `kk-KZ`, `ko-KR`, `ku`, `ky-KG`, `la`, `lb-LU`, `lg`, `lij`, `ln-CD`, `lo-LA`, `lt-LT`, `luo-KE`, `lv-LV`, `mg`, `mi-NZ`, `mk-MK`, `mn-MN`, `ms-MY`, `mt-MT`, `nb-NO`, `nl-NL`, `nso-ZA`, `ny-MW`, `oc-FR`, `pl-PL`, `ps-AF`, `pt-BR`, `pt-PT`, `ro-RO`, `roh`, `ru-RU`, `rw-RW`, `sah`, `sk-SK`, `sl-SI`, `sm`, `sn-ZW`, `so-SO`, `sq-AL`, `sr-Latn-RS`, `sr-RS`, `srd`, `ss`, `su-ID`, `sv-SE`, `sw-KE`, `sw-TZ`, `tg-TJ`, `th-TH`, `tk`, `tn`, `tok`, `ton`, `tr-TR`, `ts-ZA`, `tt`, `uk-UA`, `umb-AO`, `ur-IN`, `ur-PK`, `uz-UZ`, `vi-VN`, `vro`, `wo-SN`, `xh-ZA`, `yi`, `yo-NG`, `yue-Hant-HK`, `zh`, `zh-HK`, `zh-TW`, `zu-ZA` | Γλώσσα του ήχου πηγής, όχι των παραγόμενων υποτίτλων. Η αντιστοίχισή της με τον ήχο βελτιώνει την ακρίβεια απομαγνητοφώνησης. |
| `translation_language` |  | enum (string) \| null | no |  | `ab`, `ace`, `ach`, `af-ZA`, `ak`, `alz`, `am-ET`, `ar-AE`, `ar-BH`, `ar-DZ`, `ar-EG`, `ar-IL`, `ar-IQ`, `ar-JO`, `ar-KW`, `ar-LB`, `ar-MA`, `ar-OM`, `ar-PS`, `ar-QA`, `ar-SA`, `ar-TN`, `awa`, `ay`, `az-AZ`, `ban`, `bbc`, `be-BY`, `bem`, `bew`, `bg-BG`, `bho`, `bik`, `bm`, `bs-BA`, `bts`, `btx`, `bua`, `ca-ES`, `ceb-PH`, `cgg`, `chm`, `ckb-IQ`, `cnh`, `co`, `crh`, `crs`, `cs-CZ`, `cv`, `cy-GB`, `da-DK`, `de-DE`, `din`, `doi`, `dov`, `dv`, `dz`, `ee`, `el-GR`, `en-AU`, `en-GB`, `en-IN`, `en-NZ`, `en-US`, `eo`, `es-AR`, `es-BO`, `es-CL`, `es-CO`, `es-CR`, `es-DO`, `es-EC`, `es-ES`, `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`, `ff`, `fi-FI`, `fil-PH`, `fj`, `fr-CA`, `fr-FR`, `fy`, `ga`, `gaa`, `gd`, `gl-ES`, `gn`, `gom`, `ha-NG`, `haw`, `he-IL`, `hil`, `hmn`, `hr-HR`, `hrx`, `ht`, `hu-HU`, `hy-AM`, `id-ID`, `ig`, `ilo`, `is-IS`, `it-IT`, `ja-JP`, `ja-Latn-JP`, `jv-ID`, `ka-GE`, `kk-KZ`, `ko-KR`, `kri`, `ktu`, `ku`, `ky-KG`, `la`, `lb-LU`, `lg`, `li`, `lij`, `lmo`, `ln-CD`, `lo-LA`, `lt-LT`, `ltg`, `luo-KE`, `lus`, `lv-LV`, `mai`, `mak`, `mg`, `mi-NZ`, `min`, `mk-MK`, `mn-MN`, `mni-Mtei`, `ms-Arab`, `ms-MY`, `mt-MT`, `nb-NO`, `new`, `nl-NL`, `nr`, `nso-ZA`, `nus`, `ny-MW`, `oc-FR`, `om`, `pag`, `pam`, `pap`, `pl-PL`, `ps-AF`, `pt-BR`, `pt-PT`, `qu`, `rn`, `ro-RO`, `rom`, `ru-RU`, `rw-RW`, `scn`, `sg`, `shn`, `sk-SK`, `sl-SI`, `sm`, `sn-ZW`, `so-SO`, `sq-AL`, `sr-Latn-RS`, `sr-RS`, `ss`, `st`, `su-ID`, `sv-SE`, `sw-KE`, `sw-TZ`, `szl`, `tet`, `tg-TJ`, `th-TH`, `ti`, `tk`, `tn`, `tr-TR`, `ts-ZA`, `tt`, `ug`, `uk-UA`, `ur-IN`, `ur-PK`, `uz-UZ`, `vi-VN`, `xh-ZA`, `yi`, `yo-NG`, `yua`, `yue-Hant-HK`, `zh`, `zh-HK`, `zh-TW`, `zu-ZA` | Γλώσσα στην οποία θα μεταφραστούν οι υπότιτλοι· για πιο αξιόπιστη μετάφραση με `srt_content` ή `srt_file_url`, δώστε επίσης τη γλώσσα πηγής στο `language`. Χωρίς γλώσσα-στόχο, οι υπότιτλοι παραμένουν στην αρχική ομιλούμενη γλώσσα. |
| `srt_file_url` |  | string (file URL) \| null | no |  | 1 – 2083 characters | Παρέχετε υπότιτλους αντί για απομαγνητοφώνηση, μεταφορτώνοντας αρχείο .srt ή επικολλώντας το URL του. |
| `srt_content` |  | string \| null | no |  |  | Ακατέργαστο κείμενο υποτίτλων σε μορφή SRT, που παρέχεται αντί για srt_file_url. Η παροχή του παρακάμπτει την απομαγνητοφώνηση. |
| `vocabulary` |  | array of object {word, replaces} \| null | no |  | ≤ 100 items | Προαιρετικό λεξιλόγιο απομαγνητοφώνησης, ενεργό μόνο όταν δεν παρέχεται ούτε srt_content ούτε srt_file_url. Συμπεριλάβετε εμπορικές ονομασίες και εξειδικευμένη ορολογία που οι πάροχοι απομαγνητοφώνησης συχνά γράφουν λάθος, για παράδειγμα "VEED" → "vid". |
| `vocabulary[].word` |  | string | yes |  | 1 – 100 characters | Παρέχετε τη σωστή ορθογραφία του όρου, κατά προτίμηση εμπορική ονομασία, όνομα προϊόντος ή εξειδικευμένο όρο του πεδίου σας. |
| `vocabulary[].replaces` |  | array of string | yes |  | 1 – 20 items | Καταχωρίστε κάθε ανορθογραφία μία φορά ώστε να αντικατασταθεί από το `word`. Η αντιστοίχιση απαιτεί πλήρη λέξη αλλά αγνοεί τα κεφαλαία: `['vid']` αντιστοιχεί σε `vid`, `Vid` και `VID`, χωρίς ξεχωριστές εγγραφές για κάθε μορφή. |
| `customization` |  | object {position, shadow, text_customizations} \| null | no |  |  | Προαιρετική προσαρμογή προεπιλογής, με διατήρηση των προεπιλεγμένων τιμών όπου παραλείπονται πεδία. Οι παρακάμψεις μπορούν να προσαρμόσουν την κατακόρυφη τοποθέτηση και την ένταση σκιάς, καθώς και τη γραμματοσειρά, το βάρος και το δεκαεξαδικό χρώμα ξεχωριστά για κάθε επίπεδο σημασίας λέξης. |
| `customization.position` |  | enum (string) \| null | no |  | `top`, `center`, `bottom` | Θέση οθόνης στον κατακόρυφο άξονα για στατικούς υπότιτλους. |
| `customization.shadow` |  | enum (string) \| null | no |  | `none`, `min`, `mid`, `max` | Βελτίωση αναγνωσιμότητας υποτίτλων σε φωτεινά ή οπτικά φορτωμένα φόντα. |
| `customization.text_customizations` |  | object {baseline, highlighted} \| null | no |  |  | Ρυθμίσεις εμφάνισης κειμένου ανά επίπεδο, για βασικές και επισημασμένες λέξεις. |
| `customization.text_customizations.baseline` |  | object {font, weight, color} \| null | no |  |  | Προεπιλεγμένη εμφάνιση κειμένου για όλες τις λέξεις της απομαγνητοφώνησης, ορατή πριν δοθεί έμφαση σε κάποια μεμονωμένη λέξη. |
| `customization.text_customizations.highlighted` |  | object {font, weight, color} \| null | no |  |  | Στυλ για το μεσαίο επίπεδο λέξεων, το οποίο οι προεπιλογές συνήθως τονίζουν με μεγαλύτερο μέγεθος ή βάρος. Οι λέξεις εισέρχονται αυτόματα σε αυτό το επίπεδο όταν επισημαίνονται ως αξιοσημείωτες, όπως βασικά ουσιαστικά, ρήματα δράσης και σημαντικά επίθετα. |

File parameters (`video`, `srt_file_url`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
  "preset": "glass"
}
```

A fuller example:

```json
{
  "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
  "preset": "glass"
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/veed/subtitles?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "preset": "glass"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/veed/subtitles?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "preset": "glass"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "preset": "glass",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/veed/subtitles", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.com/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "veed/subtitles",
      "input": {
        "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
        "preset": "glass"
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "veed/subtitles",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "preset": "glass"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `video` | object {url, content_type, file_name, file_size} | Αποδοσμένο βίντεο που περιέχει μορφοποιημένους υπότιτλους. |

## Related models

- [Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0/text.md) (`veed/fabric-1.0/text`): from $2.40 / run
- [Fabric 1.0 Fast](https://doitong.com/developers/models/veed/fabric-1.0/fast.md) (`veed/fabric-1.0/fast`): from $0.10 / second of input audio
- [Lipsync](https://doitong.com/developers/models/veed/lipsync.md) (`veed/lipsync`): $0.40 / minute of output video
- [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0.md) (`veed/fabric-1.0`): from $0.08 / second of input audio
- [VEED Clean Audio](https://doitong.com/developers/models/veed/clean-audio.md) (`veed/clean-audio`): $0.0125 / minute of input audio
- [AMT Interpolation](https://doitong.com/developers/models/amt-interpolation.md) (`amt-interpolation`): $0.000575 / second of processing time
- [AnimateDiff Turbo · Video to Video](https://doitong.com/developers/models/fast-animatediff/turbo/video-to-video.md) (`fast-animatediff/turbo/video-to-video`): $0.00125 / second of processing time
- [AnimateDiff · Video to Video](https://doitong.com/developers/models/fast-animatediff/video-to-video.md) (`fast-animatediff/video-to-video`): $0.00125 / second of processing time

## Links

- HTML page: https://doitong.com/developers/models/veed/subtitles
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=veed/subtitles
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/veed/subtitles