이용 안내

JSON2Video API 및 어플리케이션 서비스는 JSON 포멧을 기반으로 하는 자동화 툴과 연동하여 동영상을 자동으로 생성할 수 있습니다.

어플리케이션 특징

  • 이미지 기반의 비디오 슬라이드쇼를 쉽고 빠르게 생성
  • 오디오, 자막, 슬라이드 간 페이드 인/아웃 등 다양한 기능 제공
  • make, zapier 등 자동화 툴과 연동 가능
  • 개인 서비스와 연동하여 맞춤형 비디오 생성 지원
  • 비디오 생성 시 1초당 1크리딧 차감
  • API 인증은 JWT 방식으로 보안 강화
  • 기본 서비스는 무료로 이용할 수 있으며, 추가 기능을 이용하기 위해서는 유료 플랜을 구매해야 합니다.
  • 유료회원의 경우 영상 생성시 내용을 분석하여 인공지능이 자동으로 효과음을 추가됩니다.
  • 유료 플랜은 회원 가입 후 이용 가능하며, 유료 플랜 가입 후 비디오 생성 시 1초당 1크리딧 차감됩니다.
  • 무료 회원의 경우 포인트 충전시 1000포인트당 100크리딧 충전됩니다.
  • 크리딧은 추후 결제 시 사용 가능합니다.

API 설명

비디오 생성 API

  • 경로: /api/json2Video
  • 메소드: POST
  • 설명: JSON 데이터를 기반으로 비디오를 생성하는 요청을 처리합니다.
curl -X POST https://json2movie.topzone.co.kr/api/json2Video \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "webhookUrl": "https://yourwebhook.com",
    "airtableId": "your_airtable_id",
    "body": {
      "scenes": [
        {
          "elements": [
            {
              "type": "image",
              "src": "https://example.com/image.jpg",
              "duration": 5
            }
          ]
        }
      ]
    }
  }'
  • X-API-Key: API 인증을 위한 키
  • webhookUrl: 비디오 생성 완료 후 호출할 웹훅 URL
  • airtableId: Airtable 연동용 ID
  • body json: 비디오 생성에 필요한 JSON 데이터

음성-텍스트 변환 API

  • 경로: /api/speech-to-text
  • 메소드: POST
  • 설명: 음성 파일을 텍스트로 변환합니다.
  • 파일 크기 제한: 50MB
curl -X POST https://json2movie.topzone.co.kr/api/speech-to-text \
  -H "Content-Type: multipart/form-data" \
  -H "X-API-Key: your_api_key" \
  -F "file=@audio.mp3"

효과음 아이템 목록 API (유료 플랜)

  • 경로: /api/presets
  • 메소드: GET
  • 설명: 효과음 아이템 목록을 조회합니다.
curl -X GET https://json2movie.topzone.co.kr/api/presets \
    -H "X-API-Key: your_api_key" \
    -H "Content-Type: application/json"

효과음 아이템 태그 목록 API (유료 플랜)

  • 경로: /api/preset-tags-string
  • 메소드: GET
  • 설명: 효과음 아이템의 태그 목록을 조회합니다.
curl -X GET https://json2movie.topzone.co.kr/api/preset-tags-string \
    -H "X-API-Key: your_api_key" \
    -H "Content-Type: application/json"

효과음 효과음 목록 API (유료 플랜)

  • 경로: /api/get-effect-preset-list
  • 메소드: GET
  • 설명: 효과음에 맞는 효과음 목록을 조회합니다.
curl -X GET https://json2movie.topzone.co.kr/api/get-effect-preset-list \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json"

효과음 스크립트 변환 API (유료 플랜)

  • 경로: /api/transform-effect-script
  • 메소드: POST
  • 설명: 효과음 스크립트를 변환합니다.
curl -X POST https://json2movie.topzone.co.kr/api/transform-effect-script \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "script": "효과음 스크립트 내용",
    "presetId": "preset_id"
  }'

오디오 속도 조절 API (유료 플랜)

  • 경로: /api/adjust-audio-speed
  • 메소드: POST
  • 설명: 오디오 파일의 재생 속도를 조절합니다.
  • 지원 파일 형식: mp3, wav, m4a, ogg, aac, flac, mpeg
  • 파일 크기 제한: 50MB
curl -X POST https://json2movie.topzone.co.kr/api/adjust-audio-speed \
  -H "Content-Type: multipart/form-data" \
  -H "X-API-Key: your_api_key" \
  -F "file=@audio.mp3" \
  -F "speed=1.5"

음성-스크립트 변환 API (유료 플랜)

  • 경로: /api/speech-to-script
  • 메소드: POST
  • 설명: 음성 파일을 스크립트로 변환합니다.
  • 파일 크기 제한: 50MB
curl -X POST https://json2movie.topzone.co.kr/api/speech-to-script \
  -H "Content-Type: multipart/form-data" \
  -H "X-API-Key: your_api_key" \
  -F "file=@audio.mp3" \
  -F "language=ko"

JSON 렌더링 모델

  • default_1: 무료 플랜용 기본 모델
  • default_3: 유료 플랜용 고급 모델
    • 효과음 자동 추가 기능
    • 오디오 속도 조절 기능
    • 고급 자막 스타일링
    • 향상된 비디오 품질
  • {
        "model": "default_1",
        "resolution": "instagram-story"
    ...

JSON 포맷

  • scenes: 비디오 씬 목록
  • elements: 씬 내 요소 목록
  • type: 요소 타입 (image, video, audio, subtitle 등)
  • src: 요소 소스(URL 등)
  • duration: 요소 지속 시간(초)

element 포맷 종류

  • image: src, duration, width, height, x, y, start
  • video: src, duration, width, height, start
  • audio: src, duration, volume, start, playAfterAudio
  • subtitle: style, start, duration, font-family, font-size, font-color, background-color, position, outline-width, max-words-per-line

자막 스타일

  • short-line: 일반 자막 스타일
  • boxed-line: max-words-per-line 기준으로 단어 강조 스타일
  • multi-line: 여러 줄 자막 스타일

자막 속성

  • font-family: Korean Bold, BlackHanSans, Gasoek One 등
  • font-size: 자막 폰트 크기
  • font-color: 자막 폰트 색상
  • background-color: 자막 배경 색상
  • position: top-left, top-center, top-right, center-left, center-center, center-right, bottom-left, bottom-center, bottom-right
  • outline-width: 자막 윤곽선 두께
  • max-words-per-line: 자막 줄당 최대 단어 수
  • {
      "font-family": "Black Han Sans",
      "style": "multi-line",
      "font-size": 190,
      "word-color": "&H15BCE6&",
      "position": "center-center",
      "outline-width": 5,
      "max-words-per-line": 3,
      "max-word-per-line": 10
    }
    ...