콘텐츠로 건너뛰기

Auto-Captioner

통합

모델 id 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"

이 요청: $0.10 100 API 크레딧 이 페이지에서 실행

API 키 받기
Utility 동영상을 동영상으로 #captioning#video

색상, 글꼴, 크기 및 위치를 조정할 수 있는 음성 기반 자막을 영상에 추가합니다

Utility · 데이터 (JSON)

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수 video_url
파일을 끌어다 놓거나

.mp4 오디오 포함 동영상의 URL입니다. 파일 크기는 400 MB 미만이어야 합니다.

고급 text_case · txt_color · txt_font · font_size · stroke_width · refresh_interval · left_align · top_align
text_case 기본값 default

'default'는 음성 인식 결과의 자막 대소문자를 유지합니다. 변경하려면 대문자 텍스트에 'upper', 소문자 텍스트에 'lower'를 선택하세요.

기본값 white

16진수 표기, RGB 튜플 또는 색상 이름으로 텍스트 색상을 설정합니다.

기본값 Standard

URL로 지정한 .ttf 파일 또는 내장 글꼴 'Arial', 'Standard', 'Garamond', 'Times New Roman', 'Georgia'로 캡션 서체를 설정합니다.

기본값 24

생성되는 캡션의 텍스트 크기입니다.

기본값 1

텍스트 외곽선 두께(픽셀)입니다.

기본값 1.5

표시 구간 동안 함께 표시되는 캡션 텍스트의 양을 제어합니다. 초 단위이며, 오래 표시할수록 한 번에 더 많은 텍스트가 나타납니다.

기본값 center

0.0~1.0의 실수 또는 이름이 지정된 위치 'left', 'center', 'right'로 텍스트를 가로 정렬합니다.

기본값 center

0.0~1.0의 실수 또는 이름이 지정된 위치 'top', 'center', 'bottom'으로 텍스트를 세로 정렬합니다.

POST /run/auto-caption?wait=20 견적 → $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"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Auto-Captioner 정보

.mp4 `video_url`(400MB 미만)의 오디오를 전사하고 영상에 자막을 입힙니다. `txt_color`, `txt_font`, `font_size`, `stroke_width`, `text_case`로 스타일을 지정합니다. 위치는 `left_align` 및 `top_align`을 사용합니다. `refresh_interval`을 0.5~3초로 설정하여 자막이 화면에 표시되는 시간을 정합니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
video_url필수 video
유형url · video
.mp4 오디오 포함 동영상의 URL입니다. 파일 크기는 400 MB 미만이어야 합니다.
txt_color선택 사항
유형string
기본값white
16진수 표기, RGB 튜플 또는 색상 이름으로 텍스트 색상을 설정합니다.
txt_font선택 사항
유형string
기본값Standard
URL로 지정한 .ttf 파일 또는 내장 글꼴 'Arial', 'Standard', 'Garamond', 'Times New Roman', 'Georgia'로 캡션 서체를 설정합니다.
font_size선택 사항
유형integer
기본값24
생성되는 캡션의 텍스트 크기입니다.
stroke_width선택 사항
유형integer
기본값1
텍스트 외곽선 두께(픽셀)입니다.
left_align선택 사항
유형string | number
기본값center
0.0~1.0의 실수 또는 이름이 지정된 위치 'left', 'center', 'right'로 텍스트를 가로 정렬합니다.
top_align선택 사항
유형string | number
기본값center
0.0~1.0의 실수 또는 이름이 지정된 위치 'top', 'center', 'bottom'으로 텍스트를 세로 정렬합니다.
refresh_interval선택 사항
유형number
기본값1.5
0.5 – 3
표시 구간 동안 함께 표시되는 캡션 텍스트의 양을 제어합니다. 초 단위이며, 오래 표시할수록 한 번에 더 많은 텍스트가 나타납니다.
text_case선택 사항
유형enum
기본값default
defaultupperlower
'default'는 음성 인식 결과의 자막 대소문자를 유지합니다. 변경하려면 대문자 텍스트에 'upper', 소문자 텍스트에 'lower'를 선택하세요.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

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"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
video_url
string (video URL)캡션이 삽입된 .mp4 동영상을 가리키는 URL입니다.

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/auto-caption.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt