Avançar para o conteúdo

Auto-Captioner

Integrar

ID do modelo auto-caption
# 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/auto-caption?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"

Este pedido: 0,10 $ 100 créditos da API Executar nesta página

Obter chave de API
Utility Vídeo para vídeo #captioning#video

Adiciona legendas baseadas em fala a um vídeo, com cor, tipo de letra, tamanho e posição ajustáveis

Utility · Dados (JSON)

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 de vídeo para um ficheiro .mp4 com áudio, inferior a 400 MB.

Avançado text_case · txt_color · txt_font · font_size · stroke_width · refresh_interval · left_align · top_align
text_case predefinição default

Escolha 'default' para manter a capitalização das legendas tal como produzida pelo reconhecimento de fala. Para a alterar, selecione 'upper' para texto em maiúsculas ou 'lower' para texto em minúsculas.

predefinição white

Defina a cor do texto com notação hexadecimal, uma tupla RGB ou um nome de cor.

predefinição Standard

Defina o tipo de letra das legendas com um URL que aponte para um ficheiro .ttf ou um tipo de letra incorporado: 'Arial', 'Standard', 'Garamond', 'Times New Roman' ou 'Georgia'.

predefinição 24

Tamanho do texto das legendas geradas.

predefinição 1

Espessura do contorno do texto, medida em píxeis.

predefinição 1.5

Controle a quantidade de texto das legendas apresentada em simultâneo durante o respetivo intervalo de visualização, medido em segundos: manter as legendas visíveis durante mais tempo mostra mais texto de uma vez.

predefinição center

Alinhe o texto horizontalmente com um float entre 0.0 e 1.0 ou selecione a posição identificada 'left', 'center' ou 'right'.

predefinição center

Alinhe o texto verticalmente com um float entre 0.0 e 1.0 ou selecione a posição identificada 'top', 'center' ou 'bottom'.

POST /run/auto-caption?wait=20 cotação → 0,10 $
# 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/auto-caption?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 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 Auto-Captioner

Transcreve o áudio de um `video_url` .mp4 (com menos de 400MB) e incorpora as legendas no vídeo. Estilize-as com `txt_color`, `txt_font`, `font_size`, `stroke_width` e `text_case`. A posição usa `left_align` e `top_align`. `refresh_interval` de 0.5 a 3 segundos define quanto tempo as legendas permanecem no ecrã.

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 de vídeo para um ficheiro .mp4 com áudio, inferior a 400 MB.
txt_coloropcional
Tipostring
Predefiniçãowhite
Defina a cor do texto com notação hexadecimal, uma tupla RGB ou um nome de cor.
txt_fontopcional
Tipostring
PredefiniçãoStandard
Defina o tipo de letra das legendas com um URL que aponte para um ficheiro .ttf ou um tipo de letra incorporado: 'Arial', 'Standard', 'Garamond', 'Times New Roman' ou 'Georgia'.
font_sizeopcional
Tipointeger
Predefinição24
Tamanho do texto das legendas geradas.
stroke_widthopcional
Tipointeger
Predefinição1
Espessura do contorno do texto, medida em píxeis.
left_alignopcional
Tipostring | number
Predefiniçãocenter
Alinhe o texto horizontalmente com um float entre 0.0 e 1.0 ou selecione a posição identificada 'left', 'center' ou 'right'.
top_alignopcional
Tipostring | number
Predefiniçãocenter
Alinhe o texto verticalmente com um float entre 0.0 e 1.0 ou selecione a posição identificada 'top', 'center' ou 'bottom'.
refresh_intervalopcional
Tiponumber
Predefinição1.5
0,5 – 3
Controle a quantidade de texto das legendas apresentada em simultâneo durante o respetivo intervalo de visualização, medido em segundos: manter as legendas visíveis durante mais tempo mostra mais texto de uma vez.
text_caseopcional
Tipoenum
Predefiniçãodefault
defaultupperlower
Escolha 'default' para manter a capitalização das legendas tal como produzida pelo reconhecimento de fala. Para a alterar, selecione 'upper' para texto em maiúsculas ou 'lower' para texto em minúsculas.
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": "auto-caption",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video_url": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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_url
string (video URL)URL que aponta para o vídeo .mp4 com legendas.

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