Saltar al cuntegna

Workflow Utilities Auto Subtitle

Integrar

ID dal model workflow-utilities/auto-subtitle
# 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/workflow-utilities/auto-subtitle?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

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

Datotecas sco l'exempel: $0,005 5 credits API tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
Utility · Video

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori video_url
Trametta in datoteca u

URL dal video per l'agiunta automatica da suttitels.

Avanzà font_weight · position · language · font_name · font_color · highlight_color · stroke_color · background_color · font_size · stroke_width · background_opacity · y_offset · words_per_subtitle · enable_animation
font_weight standard bold

Grondezza dal text; il stil tipic da TikTok dovra bold u black.

position standard bottom

Posiziun dals suttitels sin l'axa verticala.

standard en

Identifitgader da la lingua da transcripziun, sco 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh', u 'ko'. In identifitgader ISO da 3 letras sco 'eng', 'spa', u 'fra' è medemamain acceptà.

standard Montserrat

Num da la font tschernì da fonts.google.com; mintga Google Font è acceptà, inclus 'Montserrat', 'Poppins', e 'BBH Sans Hegarty'.

standard white

Colur utilisada per ils pleds dals suttitels che na vegnan betg activads.

standard purple

Colur da marcaziun en stil karaoke applitgada al pled che vegn pronunzià.

standard black

Colur applitgada al contur dal text.

standard none

Colur dal fund davos il text; 'none' e 'transparent' deactiveschan omaduas il fund.

standard 100

Grondezza da la font dals suttitels; il stil da TikTok dovra text pli grond.

standard 3

Larghezza dal contur dal text, mesirada en pixels; 0 la deactivescha.

standard 0

Opacitad dal fund, nua che 0.0 signifitga dal tuttafatg transparent e 1.0 dal tuttafatg opac.

standard 75

Dislocaziun verticala en pixels; valurs positivas spostan engiu, valurs negativas spostan ensi.

standard 3

Limit dal dumber da pleds per suttitels: 1 per in singul pled, 2–3 per ina curta frasa u 8–12 pleds per segment per ina frasa cumpletta.

POST /run/workflow-utilities/auto-subtitle?wait=20 calculaziun → $0,005
# 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/workflow-utilities/auto-subtitle?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Workflow Utilities Auto Subtitle

Transcriva il discurrì d'in video e integrescha sutrititels cun il pled actual evidenzià. Las opziuns da stil includan mintga num da Google Font, grondezza 20-150, pais, colurs dal text e da l'evidenziaziun, contur, colur e opacitad dal fund, sco er posiziun sura, centrala u sut cun offset vertical. `words_per_subtitle` tanscha da 1 to 12, e in'animaziun bounce po vegnir activada u deactivada. Restituescha er la transcripziun e las tempis dals pleds.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
video_urlobligatori video
Tipurl · video
URL dal video per l'agiunta automatica da suttitels.
languageopziunal
Tipstring
Standarden
Identifitgader da la lingua da transcripziun, sco 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh', u 'ko'. In identifitgader ISO da 3 letras sco 'eng', 'spa', u 'fra' è medemamain acceptà.
font_nameopziunal
Tipstring
StandardMontserrat
Num da la font tschernì da fonts.google.com; mintga Google Font è acceptà, inclus 'Montserrat', 'Poppins', e 'BBH Sans Hegarty'.
font_sizeopziunal
Tipinteger
Standard100
20 – 150
Grondezza da la font dals suttitels; il stil da TikTok dovra text pli grond.
font_weightopziunal
Tipenum
Standardbold
normalboldblack
Grondezza dal text; il stil tipic da TikTok dovra bold u black.
font_coloropziunal
Tipenum
Standardwhite
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Colur utilisada per ils pleds dals suttitels che na vegnan betg activads.
highlight_coloropziunal
Tipenum
Standardpurple
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Colur da marcaziun en stil karaoke applitgada al pled che vegn pronunzià.
stroke_widthopziunal
Tipinteger
Standard3
0 – 10
Larghezza dal contur dal text, mesirada en pixels; 0 la deactivescha.
stroke_coloropziunal
Tipenum
Standardblack
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Colur applitgada al contur dal text.
background_coloropziunal
Tipenum
Standardnone
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagentanonetransparent
Colur dal fund davos il text; 'none' e 'transparent' deactiveschan omaduas il fund.
background_opacityopziunal
Tipnumber
Standard0
0 – 1
Opacitad dal fund, nua che 0.0 signifitga dal tuttafatg transparent e 1.0 dal tuttafatg opac.
positionopziunal
Tipenum
Standardbottom
topcenterbottom
Posiziun dals suttitels sin l'axa verticala.
y_offsetopziunal
Tipinteger
Standard75
-200 – 200
Dislocaziun verticala en pixels; valurs positivas spostan engiu, valurs negativas spostan ensi.
words_per_subtitleopziunal
Tipinteger
Standard3
1 – 12
Limit dal dumber da pleds per suttitels: 1 per in singul pled, 2–3 per ina curta frasa u 8–12 pleds per segment per ina frasa cumpletta.
enable_animationopziunal
Tipboolean
Standardtrue
Activescha l'animaziun dals suttitels cun in effect d'entrada saltant.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "workflow-utilities/auto-subtitle",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "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
    },
    "transcription": "string",
    "subtitle_count": 1,
    "words": [
      {}
    ],
    "transcription_metadata": {}
  },
  "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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
video
object {url, content_type, file_name, file_size}Video cun suttitels generads automaticamain.
transcription
stringText cumplett da la transcripziun.
subtitle_count
integerDumber dals segments da suttitels generads.
words
array of object | nullDatas da temp per singuls pleds furnidas dal servetsch da transcripziun.
transcription_metadata
object | nullMetadatas supplementaras furnidas da ElevenLabs per la transcripziun, inclusiv lingua, segments e auters detagls.

Dapli models: Video a video

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/workflow-utilities/auto-subtitle.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt