Captions.ai API 완벽 가이드: 비디오 생성부터 편집까지 모든 것

Captions.ai API 완벽 가이드: 비디오 생성부터 편집까지 모든 것

Captions.ai API는 AI 기술을 활용해 비디오 콘텐츠를 자동으로 생성, 편집, 번역할 수 있는 강력한 도구입니다. 이 가이드에서는 API의 모든 기능과 사용법을 상세히 알아보겠습니다.

Captions.ai API 서비스 구조

다음은 Captions.ai에서 제공하는 5가지 주요 API 서비스와 크레딧 시스템을 보여주는 구조도입니다

서비스 개요

Captions.ai API는 크게 5가지 주요 서비스를 제공합니다:

1. AI Creator - 스크립트를 기반으로 AI 가상 캐릭터가 등장하는 비디오 생성
2. AI Ads - 제품이나 서비스를 홍보하는 광고 비디오 생성
3. AI Twin - 사용자 맞춤형 가상 아바타(AI Twins) 관리
4. AI Translate - 비디오 콘텐츠를 다양한 언어로 번역
5. AI Edit - AI를 활용한 비디오 편집 (기업 고객 전용)

각 서비스는 서로 다른 비율로 크레딧을 소모하며, API를 활용하기 위해서는 시작 전 API 키 생성과 크레딧 구매가 필요합니다.

API 시작하기

1. API 키 생성

API 대시보드에서 개인 API 키를 생성합니다.

2. 크레딧 구매

가격 정책:

• 1 크레딧당 $0.05
• 최소 구매: 100 크레딧 ($5)
• 최대 구매: 12,000 크레딧 ($600)

3. API 이용 약관 동의

Captions API 약관에 동의해야 서비스를 이용할 수 있습니다.

서비스별 크레딧 소모량

서비스 크레딧 소모 예시

AI Creator	초당 1크레딧	30초 비디오 = 30크레딧
AI Ads	초당 1크레딧	45초 광고 = 45크레딧
AI Twin	무료	API 접근만 해당
AI Translate	초당 1크레딧	2분 비디오 = 120크레딧
AI Edit	초당 2크레딧	40초 비디오 = 80크레딧

API 사용 제한

각 서비스는 분당 요청 수 제한이 있습니다:

서비스 분당 최대 요청 수

AI Creator	5
AI Ads	5
AI Twin	5
AI Translate	5
AI Edit	1

주요 API 사용법

AI Creator API

스크립트를 기반으로 AI 가상 캐릭터가 등장하는 비디오를 생성합니다.

기본 사용 과정:

1. 크리에이터 목록 조회

curl -X GET "https://api.captions.ai/ai-creators/list" -H "Authorization: Bearer YOUR_API_KEY"

1. 비디오 생성 요청

curl -X POST "https://api.captions.ai/ai-creators/submit" 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -d '{"script": "비디오 스크립트", "creator": "크리에이터_이름"}'

1. 생성 상태 확인 및 완성된 비디오 다운로드

curl -X GET "https://api.captions.ai/ai-creators/poll?request_id=YOUR_REQUEST_ID" -H "Authorization: Bearer YOUR_API_KEY"

AI Translate API

비디오 콘텐츠를 다양한 언어로 번역하는 서비스입니다.

주요 특징:

• 최대 비디오 길이: Lipdub 없으면 5분, 있으면 1분
• 다양한 언어 지원 (API로 확인 가능)

기본 사용 과정:

1. 지원 언어 목록 조회

curl -X GET "https://api.captions.ai/ai-translate/supported-languages" -H "Authorization: Bearer YOUR_API_KEY"

1. 번역 요청 (립싱크 옵션 포함)

curl -X POST "https://api.captions.ai/ai-translate/submit" 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -d '{"video_url": "비디오_URL", "target_language": "언어_코드", "lipdub": true}'

유용한 팁

1. 크레딧 관리: 프로젝트 시작 전 필요한 크레딧을 미리 계산하세요. 예를 들어, 1분 비디오 번역에는 60크레딧이 필요합니다.
2. 요청 분산: API 요청 제한에 걸리지 않도록 요청을 적절히 분산하세요.
3. AI Twin 활용: 무료로 제공되는 AI Twin API를 활용해 커스텀 아바타로 비디오를 생성하세요.
4. 기업 고객 혜택: 기업 고객은 AI Edit API와 같은 추가 서비스를 이용할 수 있습니다.

자주 묻는 질문 (FAQ)

Q: 테스트 환경이 제공되나요? A: 아니요, 현재 테스트 환경은 제공되지 않습니다. 실제 사용을 위한 크레딧을 구매해야 합니다.

Q: AI Twin은 어떻게 생성하나요? A: AI Twin은 Captions iPhone 앱(안드로이드 곧 지원)에서 생성 가능하며, 생성 후 API를 통해 접근할 수 있습니다.

Q: 비디오 생성에 얼마나 시간이 소요되나요? A: 비디오 생성 시간은 요청의 복잡성과 서버 부하에 따라 다릅니다. /poll 엔드포인트로 상태를 주기적으로 확인하세요.

더 자세한 내용은 아래 문서 참조

전체 API 가이드와 더 많은 예제는 전체 문서를 참조하세요.