# Subtitles API

> Menyematkan subtitle bergaya ke dalam video dari transkripsi otomatis atau SRT Anda sendiri, dengan terjemahan opsional

Menambahkan takarir yang dirender ke video (`video_url`) menggunakan `preset` gaya yang wajib diisi, dengan 30 prasetel tersedia. Model ini melakukan transkripsi secara otomatis, atau melewatinya jika Anda memberikan `srt_file_url` atau `srt_content`. `language` menetapkan bahasa sumber untuk akurasi, dan `translation_language` menerjemahkan takarir. Daftar `vocabulary` hingga 100 istilah dan penggantian `customization` menyempurnakan hasil.

- 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/id/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 | Video sumber untuk subtitle; unggah file atau tempel URL-nya. |
| `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` | Pilihan gaya yang mengatur tipografi, warna, susunan, dan animasi, dengan rendering yang lebih kaya dan responsif terhadap konteks input. Preset dasar menggunakan pengali 1 dan memberikan hasil yang dapat diprediksi melalui gaya tetap yang ringan: 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` | Bahasa audio sumber, bukan subtitle yang dibuat. Menyesuaikannya dengan audio meningkatkan akurasi transkripsi. |
| `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` | Bahasa tujuan untuk menerjemahkan subtitle; untuk terjemahan paling andal dengan `srt_content` atau `srt_file_url`, sertakan juga bahasa sumbernya dalam `language`. Tanpa bahasa target, subtitle tetap dalam bahasa asli yang diucapkan. |
| `srt_file_url` |  | string (file URL) \| null | no |  | 1 – 2083 characters | Masukkan subtitle, bukan menjalankan transkripsi, dengan mengunggah file .srt atau menempelkan URL-nya. |
| `srt_content` |  | string \| null | no |  |  | Teks subtitle mentah dalam format SRT, diberikan sebagai pengganti srt_file_url. Menyediakannya akan melewati transkripsi. |
| `vocabulary` |  | array of object {word, replaces} \| null | no |  | ≤ 100 items | Kosakata transkripsi opsional, aktif hanya jika srt_content dan srt_file_url tidak diberikan. Sertakan nama merek dan jargon khusus yang sering salah dieja oleh penyedia transkripsi, misalnya "VEED" → "vid". |
| `vocabulary[].word` |  | string | yes |  | 1 – 100 characters | Berikan ejaan yang benar untuk istilah tersebut, sebaiknya merek, nama produk, atau istilah khusus dari domain Anda. |
| `vocabulary[].replaces` |  | array of string | yes |  | 1 – 20 items | Cantumkan setiap salah eja sekali agar diganti dengan `word`. Pencocokan memerlukan kata lengkap tetapi mengabaikan kapitalisasi: `['vid']` cocok dengan `vid`, `Vid`, dan `VID`, tanpa entri terpisah untuk setiap variasi huruf besar-kecil. |
| `customization` |  | object {position, shadow, text_customizations} \| null | no |  |  | Penyesuaian preset opsional, dengan mempertahankan nilai bawaan pada bidang yang dihilangkan. Penggantian dapat menyesuaikan posisi vertikal dan kekuatan bayangan, serta font, ketebalan, dan warna heksadesimal secara terpisah untuk setiap tingkat kepentingan kata. |
| `customization.position` |  | enum (string) \| null | no |  | `top`, `center`, `bottom` | Posisi layar pada sumbu vertikal untuk subtitle statis. |
| `customization.shadow` |  | enum (string) \| null | no |  | `none`, `min`, `mid`, `max` | Peningkatan keterbacaan subtitle pada latar belakang terang atau yang ramai secara visual. |
| `customization.text_customizations` |  | object {baseline, highlighted} \| null | no |  |  | Pengaturan tampilan teks berdasarkan tingkat, yang mencakup kata dasar dan kata yang disorot. |
| `customization.text_customizations.baseline` |  | object {font, weight, color} \| null | no |  |  | Tampilan teks bawaan untuk semua kata transkrip, terlihat sebelum kata tertentu menerima penekanan. |
| `customization.text_customizations.highlighted` |  | object {font, weight, color} \| null | no |  |  | Gaya untuk tingkat kata peringkat menengah, yang biasanya ditekankan oleh preset dengan ukuran atau ketebalan lebih besar. Kata masuk ke tingkat ini secara otomatis saat ditandai penting, termasuk kata benda utama, kata kerja tindakan, dan kata sifat yang menonjol. |

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} | Video hasil render yang berisi subtitle bergaya. |

## 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