Avançar para o conteúdo

Workflow Utilities Auto Subtitle

Integrar

ID do modelo 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ficheiros como o exemplo: 0,005 $ 5 créditos da API · ≈ 0,52 ₽ os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
Utility · 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

URL do vídeo para adicionar legendas automaticamente.

Avançado 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 predefinição bold

Peso do texto; o estilo habitual do TikTok utiliza negrito ou preto.

position predefinição bottom

Posicionamento das legendas ao longo do eixo vertical.

predefinição en

Identificador do idioma da transcrição, como 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh' ou 'ko'. Também é aceite um identificador ISO de 3 letras, como 'eng', 'spa' ou 'fra'.

predefinição Montserrat

Nome do tipo de letra selecionado em fonts.google.com; é aceite qualquer Google Font, incluindo 'Montserrat', 'Poppins' e 'BBH Sans Hegarty'.

predefinição white

Cor utilizada nas palavras das legendas que não estão ativas.

predefinição purple

Cor de realce ao estilo karaoke aplicada à palavra que está a ser pronunciada.

predefinição black

Cor aplicada ao contorno ou traço do texto.

predefinição none

Cor do fundo atrás do texto; 'none' e 'transparent' desativam ambos o fundo.

predefinição 100

Tamanho do tipo de letra das legendas; o estilo do TikTok utiliza texto maior.

predefinição 3

Largura do contorno ou traço do texto, medida em píxeis; 0 desativa-o.

predefinição 0

Opacidade do fundo, em que 0.0 significa totalmente transparente e 1.0 totalmente opaco.

predefinição 75

Deslocamento vertical em píxeis; valores positivos deslocam para baixo, enquanto valores negativos deslocam para cima.

predefinição 3

Limite de palavras por legenda, permitindo apresentar uma única palavra com 1, uma frase curta com 2–3 ou uma frase completa com 8–12 palavras por segmento.

POST /run/workflow-utilities/auto-subtitle?wait=20 cotação → 0,005 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/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 Workflow Utilities Auto Subtitle

Transcreve a fala de um vídeo e insere legendas com destaque da palavra atualmente falada. As opções de estilo incluem qualquer nome de Google Font, tamanho 20-150, peso, cores do texto e do destaque, contorno, cor e opacidade do fundo, e posicionamento no topo, centro ou fundo com deslocamento vertical. `words_per_subtitle` varia de 1 a 12 e é possível ativar ou desativar uma animação de ressalto. Também devolve a transcrição e os tempos das palavras.

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
URL do vídeo para adicionar legendas automaticamente.
languageopcional
Tipostring
Predefiniçãoen
Identificador do idioma da transcrição, como 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh' ou 'ko'. Também é aceite um identificador ISO de 3 letras, como 'eng', 'spa' ou 'fra'.
font_nameopcional
Tipostring
PredefiniçãoMontserrat
Nome do tipo de letra selecionado em fonts.google.com; é aceite qualquer Google Font, incluindo 'Montserrat', 'Poppins' e 'BBH Sans Hegarty'.
font_sizeopcional
Tipointeger
Predefinição100
20 – 150
Tamanho do tipo de letra das legendas; o estilo do TikTok utiliza texto maior.
font_weightopcional
Tipoenum
Predefiniçãobold
normalboldblack
Peso do texto; o estilo habitual do TikTok utiliza negrito ou preto.
font_coloropcional
Tipoenum
Predefiniçãowhite
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Cor utilizada nas palavras das legendas que não estão ativas.
highlight_coloropcional
Tipoenum
Predefiniçãopurple
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Cor de realce ao estilo karaoke aplicada à palavra que está a ser pronunciada.
stroke_widthopcional
Tipointeger
Predefinição3
0 – 10
Largura do contorno ou traço do texto, medida em píxeis; 0 desativa-o.
stroke_coloropcional
Tipoenum
Predefiniçãoblack
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Cor aplicada ao contorno ou traço do texto.
background_coloropcional
Tipoenum
Predefiniçãonone
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagentanonetransparent
Cor do fundo atrás do texto; 'none' e 'transparent' desativam ambos o fundo.
background_opacityopcional
Tiponumber
Predefinição0
0 – 1
Opacidade do fundo, em que 0.0 significa totalmente transparente e 1.0 totalmente opaco.
positionopcional
Tipoenum
Predefiniçãobottom
topcenterbottom
Posicionamento das legendas ao longo do eixo vertical.
y_offsetopcional
Tipointeger
Predefinição75
-200 – 200
Deslocamento vertical em píxeis; valores positivos deslocam para baixo, enquanto valores negativos deslocam para cima.
words_per_subtitleopcional
Tipointeger
Predefinição3
1 – 12
Limite de palavras por legenda, permitindo apresentar uma única palavra com 1, uma frase curta com 2–3 ou uma frase completa com 8–12 palavras por segmento.
enable_animationopcional
Tipoboolean
Predefiniçãotrue
Ativa a animação das legendas com um efeito de entrada com ressalto.
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": "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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 com legendas geradas automaticamente.
transcription
stringTexto completo da transcrição.
subtitle_count
integerNúmero de segmentos de legendas gerados.
words
array of object | nullDados temporais de palavras individuais fornecidos pelo serviço de transcrição.
transcription_metadata
object | nullMetadados adicionais fornecidos pela ElevenLabs para a transcrição, incluindo idioma, segmentos e outros detalhes.

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/workflow-utilities/auto-subtitle.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt