Avançar para o conteúdo

Subtitles

Integrar

ID do modelo veed/subtitles
# 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": "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"

Ficheiros como o exemplo: 0,20 $ 200 créditos da API os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API

Incorpora legendas estilizadas num vídeo, a partir de transcrição automática ou do seu próprio SRT, com tradução opcional

VEED · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório video_url
Largue um ficheiro ou

Vídeo de origem para legendagem; carregue o ficheiro ou cole a respetiva URL.

•obrigatório

Seleção de estilo que define tipografia, cor, disposição e animação, com rendering mais rico adaptado ao contexto da entrada. As predefinições básicas utilizam um multiplicador de 1 e fornecem resultados previsíveis através de um estilo fixo e leve: vegas, rizz, mint, flex, sprout, karl, hustle, kitty, slay, ali, diego, vinta, lowkey, capri, casper, shadeplay, boo, corpo, beans, plain, simple.

Idioma para o qual traduzir as legendas; para obter a tradução mais fiável com `srt_content` ou `srt_file_url`, forneça também o idioma de origem em `language`. Sem um destino, as legendas permanecem no idioma falado original.

Avançado srt_file_url · language · srt_content · vocabulary · customization
Largue um ficheiro ou

Forneça legendas em vez de executar a transcrição, carregando um ficheiro .srt ou colando a respetiva URL.

Idioma do áudio de origem, não das legendas geradas. Correspondê-lo ao áudio melhora a precisão da transcrição.

Texto de legendas bruto no formato SRT, fornecido em vez de srt_file_url. Fornecê-lo ignora a transcrição.

Vocabulário de transcrição opcional, ativo apenas quando não é fornecido srt_content nem srt_file_url. Inclua nomes de marcas e jargão especializado que os fornecedores de transcrição frequentemente escrevem incorretamente, por exemplo "VEED" → "vid".

Personalização opcional da predefinição, mantendo os valores predefinidos sempre que os campos são omitidos. As substituições podem ajustar a posição vertical e a intensidade da sombra, além do tipo de letra, peso e cor hexadecimal separadamente para cada nível de importância das palavras.

POST /run/veed/subtitles?wait=20 cotação → 0,20 $
# 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": "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"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Subtitles

Adiciona legendas renderizadas a um vídeo (`video_url`) usando um `preset` de estilo obrigatório, com 30 predefinições disponíveis. Transcreve automaticamente ou ignora essa etapa se fornecer `srt_file_url` ou `srt_content`. `language` define o idioma de origem para maior precisão, e `translation_language` traduz as legendas. Uma lista `vocabulary` com até 100 termos e substituições em `customization` permitem aperfeiçoar o resultado.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
video_urlobrigatório video
Tipourl · video
≤ 2083 caracteres
Vídeo de origem para legendagem; carregue o ficheiro ou cole a respetiva URL.
presetobrigatório
Tipoenum
glasswhisperglide2fusionglideterminalhandwrittenbackdropbackdrop2simpleplainbeanscorpobooshadeplaycasper
+14 maiscaprilowkeyvintadiegoalislaykittyhustlekarlsproutflexmintrizzvegas
Seleção de estilo que define tipografia, cor, disposição e animação, com rendering mais rico adaptado ao contexto da entrada. As predefinições básicas utilizam um multiplicador de 1 e fornecem resultados previsíveis através de um estilo fixo e leve: vegas, rizz, mint, flex, sprout, karl, hustle, kitty, slay, ali, diego, vinta, lowkey, capri, casper, shadeplay, boo, corpo, beans, plain, simple.
languageopcional
Tipoenum
af-ZAam-ETar-AEar-BHar-DZar-EGar-ILar-IQar-JOar-KWar-LBar-MAar-OMar-PSar-QAar-SA
+148 maisar-TNast-ESaz-AZbabasbe-BYbg-BGbrbs-BAca-ESceb-PHckb-IQcs-CZcy-GBda-DKde-DEdyuel-GRen-AUen-GBen-INen-NZen-USeoes-ARes-BOes-CLes-COes-CRes-DOes-ECes-ESes-GTes-HNes-MXes-NIes-PAes-PEes-PRes-PYes-SVes-USes-UYes-VEet-EEeu-ESfa-IRfffi-FIfil-PHfofr-CAfr-FRfygagdgl-ESha-NGhawhe-ILhr-HRhsbhthu-HUhy-AMid-IDigis-ISit-ITja-JPja-Latn-JPjv-IDka-GEkabkam-KEkea-CVkk-KZko-KRkuky-KGlalb-LUlglijln-CDlo-LAlt-LTluo-KElv-LVmgmi-NZmk-MKmn-MNms-MYmt-MTnb-NOnl-NLnso-ZAny-MWoc-FRpl-PLps-AFpt-BRpt-PTro-ROrohru-RUrw-RWsahsk-SKsl-SIsmsn-ZWso-SOsq-ALsr-Latn-RSsr-RSsrdsssu-IDsv-SEsw-KEsw-TZtg-TJth-THtktntoktontr-TRts-ZAttuk-UAumb-AOur-INur-PKuz-UZvi-VNvrowo-SNxh-ZAyiyo-NGyue-Hant-HKzhzh-HKzh-TWzu-ZA
Idioma do áudio de origem, não das legendas geradas. Correspondê-lo ao áudio melhora a precisão da transcrição.
translation_languageopcional
Tipoenum
abaceachaf-ZAakalzam-ETar-AEar-BHar-DZar-EGar-ILar-IQar-JOar-KWar-LB
+198 maisar-MAar-OMar-PSar-QAar-SAar-TNawaayaz-AZbanbbcbe-BYbembewbg-BGbhobikbmbs-BAbtsbtxbuaca-ESceb-PHcggchmckb-IQcnhcocrhcrscs-CZcvcy-GBda-DKde-DEdindoidovdvdzeeel-GRen-AUen-GBen-INen-NZen-USeoes-ARes-BOes-CLes-COes-CRes-DOes-ECes-ESes-GTes-HNes-MXes-NIes-PAes-PEes-PRes-PYes-SVes-USes-UYes-VEet-EEeu-ESfa-IRfffi-FIfil-PHfjfr-CAfr-FRfygagaagdgl-ESgngomha-NGhawhe-ILhilhmnhr-HRhrxhthu-HUhy-AMid-IDigilois-ISit-ITja-JPja-Latn-JPjv-IDka-GEkk-KZko-KRkriktukuky-KGlalb-LUlglilijlmoln-CDlo-LAlt-LTltgluo-KEluslv-LVmaimakmgmi-NZminmk-MKmn-MNmni-Mteims-Arabms-MYmt-MTnb-NOnewnl-NLnrnso-ZAnusny-MWoc-FRompagpampappl-PLps-AFpt-BRpt-PTqurnro-ROromru-RUrw-RWscnsgshnsk-SKsl-SIsmsn-ZWso-SOsq-ALsr-Latn-RSsr-RSssstsu-IDsv-SEsw-KEsw-TZszltettg-TJth-THtitktntr-TRts-ZAttuguk-UAur-INur-PKuz-UZvi-VNxh-ZAyiyo-NGyuayue-Hant-HKzhzh-HKzh-TWzu-ZA
Idioma para o qual traduzir as legendas; para obter a tradução mais fiável com `srt_content` ou `srt_file_url`, forneça também o idioma de origem em `language`. Sem um destino, as legendas permanecem no idioma falado original.
srt_file_urlopcional
Tipourl · file
≤ 2083 caracteres
Forneça legendas em vez de executar a transcrição, carregando um ficheiro .srt ou colando a respetiva URL.
srt_contentopcional
Tipostring | null
Texto de legendas bruto no formato SRT, fornecido em vez de srt_file_url. Fornecê-lo ignora a transcrição.
vocabularyopcional
Tipoobject[]
≤ 100 itens
Vocabulário de transcrição opcional, ativo apenas quando não é fornecido srt_content nem srt_file_url. Inclua nomes de marcas e jargão especializado que os fornecedores de transcrição frequentemente escrevem incorretamente, por exemplo "VEED" → "vid".
vocabulary[].wordobrigatório
Tipostring
1 – 100 characters
Forneça a grafia correta do termo, de preferência uma marca, nome de produto ou termo especializado do seu domínio.
vocabulary[].replacesobrigatório
Tipostring[]
1 – 20 items
Indique cada erro ortográfico uma vez para que seja substituído por `word`. A correspondência requer uma palavra completa, mas ignora maiúsculas e minúsculas: `['vid']` corresponde a `vid`, `Vid` e `VID`, sem entradas separadas para cada caso.
customizationopcional
Tipoobject
Personalização opcional da predefinição, mantendo os valores predefinidos sempre que os campos são omitidos. As substituições podem ajustar a posição vertical e a intensidade da sombra, além do tipo de letra, peso e cor hexadecimal separadamente para cada nível de importância das palavras.
customization.positionopcional
Tipoenum
topcenterbottom
Posição do ecrã ao longo do eixo vertical para legendas estáticas.
customization.shadowopcional
Tipoenum
noneminmidmax
Melhoria da legibilidade das legendas sobre fundos claros ou visualmente complexos.
customization.text_customizationsopcional
Tipoobject
Definições do aspeto do texto por nível, abrangendo palavras base e palavras destacadas.
customization.text_customizations.baselineopcional
Tipoobject
Aspeto predefinido do texto para todas as palavras da transcrição, visível antes de qualquer palavra individual receber ênfase.
customization.text_customizations.highlightedopcional
Tipoobject
Estilo para o nível intermédio de palavras, que as predefinições normalmente destacam com maior tamanho ou peso. As palavras entram automaticamente neste nível quando são marcadas como relevantes, incluindo substantivos essenciais, verbos de ação e adjetivos importantes.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
video
object {url, content_type, file_name, file_size}Vídeo renderizado que contém legendas estilizadas.

Mais modelos: Vídeo para vídeo

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/veed/subtitles.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt