이용 안내
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/save-youtube-link
- 메소드: POST
- 설명: 유튜브 영상 링크를 저장합니다.
curl -X POST https://json2movie.topzone.co.kr/api/save-youtube-link \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"youtubeUrl": "https://www.youtube.com/watch?v=example",
"title": "영상 제목",
"description": "영상 설명"
}'
효과음 아이템 목록 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/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
}
...