Creatify API

API로 만들 수 있는 것

소개 문서는 엔드포인트, 즉 작업마다 코드가 호출하는 별도 주소를 반환되는 영상 종류별로 묶어 둡니다. 호출하면 작업이 시작되고, 상태가 done으로 바뀌면 파일을 받아 가면 됩니다.

• URL to Video는 상품 페이지 링크로 광고를 만듭니다.
• AI Avatar는 두 가지 버전이 있으며, 진행자와 대본을 화면에 보여 줍니다. 버전 2은 장면마다 아바타, 음성, 배경을 따로 지정한 영상을 만듭니다.
• Aurora는 사진 한 장과 오디오 트랙으로 말하는 영상을 만듭니다(Aurora 가이드).
• Boreal은 프롬프트, 이미지, 오디오 트랙으로 영상을 만듭니다.
• 이 밖에 Custom Templates, Custom Avatar, Ad Clone, Asset Generator, HTML Interactive Ad 엔드포인트가 있습니다.

요금 페이지에는 텍스트 투 스피치, AI 스크립트, 링크 생성, AI Shorts, AI 편집 같은 소규모 호출도 나와 있습니다. 문서는 AI Shorts와 AI Editing을 지원 중단 예정으로 표시하고 있습니다. 문서에는 브라우저에서 호출을 시험해 볼 수 있는 Playground와 변경 내역도 있습니다.

크레딧을 달러로 환산하면

가격 페이지에는 AI Avatar와 Aurora 가격이 이미 나와 있습니다(Creatify 가격). 이 표는 요금 페이지의 나머지 항목을 크레딧을 모두 사용한다고 가정해 환산한 것입니다. 여기서는 Boreal이 30초에 3크레딧으로 가장 낮고, Ad Clone이 72크레딧으로 가장 높습니다.

과금 단위는 호출마다 다릅니다. AI Avatar와 URL to Video는 30초 단위, Boreal은 10초 단위, Ad Clone은 레퍼런스 광고의 5초 단위로 청구됩니다.

문서 두 곳이 요금 페이지와 맞지 않습니다. URL to Video 가이드는 30초당 4크레딧이라고 밝히지만 예시에는 5이 사용된 것으로 나오고, 요금 페이지는 5를 청구합니다. 4는 렌더 단계와 일치하며, 별도의 미리보기 호출은 1이라고 밝힙니다. Ad Clone 가이드는 30초 레퍼런스에 72크레딧이라고 밝히지만 예시 작업에는 15이 사용된 것으로 나옵니다. 표는 요금 페이지를 따랐습니다.

광고 한 편, 앱과 API 비교

크레딧을 모두 사용한다고 가정하면 앱에서 30초 아바타 광고는 10크레딧이 들며, 월 15달러 Standard 플랜 기준 2.73달러입니다. API Starter에서 같은 길이의 AI Avatar는 5크레딧, 즉 0.99달러입니다. Starter는 광고를 몇 편 만들든 월 99달러이고, 500크레딧으로 100편을 만들 수 있습니다. 앱 플랜 구간과 API 비용이 교차하는 지점은 Creatify 가격에서 확인할 수 있습니다.

앱에는 미리보기와 웹 편집기가 있습니다(Creatify 사용법). API에는 자체 미리보기와 렌더 호출이 있으며, 수정하려면 새로 요청해야 합니다.

API 플랜이 필요할까?

코드로 쓴다면 필요합니다. 아래의 MCP 방식은 필요 없습니다. 요금 페이지는 “API 접근과 월 크레딧을 이용하려면” 플랜을 구독해야 한다고 안내합니다. 퀵스타트는 접근에 활성 구독이 필요하다고 밝힙니다. 앱 플랜에 API 접근이 포함된다는 설명은 어느 페이지에도 없습니다.

요금 문서에는 구독 페이지 링크가 있고, creatify.ai/pricing의 API 탭에는 플랜별 Get Started 버튼이 있습니다. 키는 앱에서 발급합니다. 계정 이름을 클릭하고 API Dashboard를 연 다음 Show API Keys를 선택합니다. Creatify API 페이지는 문의 양식과 데모를 앞세우며 가격은 나와 있지 않습니다.

첫 요청 보내기

코드를 쓰지 않는다면 이 부분은 개발자에게 넘기면 됩니다. 퀵스타트에 따르면 모든 요청은 https://api.creatify.ai로 보내며, 헤더 두 개 X-API-ID와 X-API-KEY를 함께 보냅니다. 키는 비밀번호처럼 다뤄야 하므로 서버에만 두고 웹 페이지에는 넣지 않습니다. 두 헤더 중 하나라도 빠지면 접근 거부를 뜻하는 401 오류가 반환됩니다.

URL to Video는 호출이 두 번 필요합니다. 첫 번째는 페이지를 읽고, 두 번째는 반환된 링크로 영상을 생성합니다.

curl -X POST https://api.creatify.ai/api/links/ \
  -H 'X-API-ID: YOUR_ID' -H 'X-API-KEY: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com/product"}'

curl -X POST https://api.creatify.ai/api/link_to_videos/ \
  -H 'X-API-ID: YOUR_ID' -H 'X-API-KEY: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"link": "LINK_ID", "aspect_ratio": "9x16", "video_length": 15}'

GET /api/link_to_videos/{id}/로 status가 done이 될 때까지 반복해서 요청한 뒤 video_output를 읽습니다. FAQ에 따르면 링크 생성은 60초 미만, URL to Video는 약 5분이 걸립니다. AI Avatar는 영상 1초당 약 10초가 걸려, 15초 영상은 약 150초가 소요됩니다.

호출이 실패하거나 크레딧이 떨어지면

결과물을 만드는 호출만 크레딧을 사용합니다. FAQ에 따르면 GET과 목록 조회 호출은 크레딧을 쓰지 않습니다. GET /api/remaining_credits/는 잔액을 반환합니다.

잔액이 부족하면 작업을 생성할 때 크레딧 부족 오류가 반환됩니다. FAQ는 추가 팩, 플랜 업그레이드, 엔터프라이즈 플랜을 해결책으로 안내하며, 추가 팩 가격은 공개되어 있지 않습니다.

환불 여부는 호출에 따라 다릅니다. 변경 내역에 따르면 실패하거나 거부된 Aurora, Boreal, Asset Generator 작업은 자동으로 환불되며, 파일은 최소 7일간 보관됩니다. URL to Video, AI Avatar, Ad Clone 가이드에는 failed_reason 필드가 있지만 환불 규정은 나와 있지 않습니다. 크레딧 유효기간도 문서에 명시되어 있지 않습니다.

Creatify MCP

MCP(Model Context Protocol)는 ChatGPT나 Claude 같은 AI 어시스턴트가 외부 툴을 쓰도록 하는 표준 방식입니다. Creatify는 Creatify Ad Agent MCP를 API 문서가 아닌 자사 사이트에 따로 소개하고 있습니다.

ChatGPT, Claude, Grok, Cursor, VS Code에서 쓸 수 있습니다. Creatify 계정으로 로그인하고 접근을 승인하면 됩니다. 페이지에는 “API 키 불필요, Free 플랜에서도 작동”이라고 적혀 있습니다. 웹 앱과 같은 크레딧을 사용하며, 설정 단계에도 API 플랜은 언급되지 않습니다.

영상 하나를 렌더링하는 데 몇 분이 걸립니다. 무료 플랜으로 내보낸 영상에는 워터마크가 붙습니다(무료 플랜 문서).

다음 글: Aurora 비용과 앱 플랜

Aurora는 API의 토킹 포토 모델이며, 버전, 제한, 호스트별 가격은 Creatify Aurora에 정리해 두었습니다. 앱 플랜과 크레딧당 비용은 Creatify 가격에서 볼 수 있습니다.

Creatify API 자주 묻는 질문

Creatify에 API가 있나요?

네. docs.creatify.ai의 문서에서 URL to Video, AI Avatar, Aurora, Boreal, Custom Templates, Ad Clone, Asset Generator를 다룹니다.

Creatify API 비용은 얼마인가요?

API Starter는 월 99달러에 500크레딧, API Pro는 월 299달러에 2,000크레딧입니다. API Enterprise는 크레딧을 맞춤으로 정하며 문의 양식으로 신청합니다.

Creatify API 키는 어디서 받나요?

앱에서 계정 이름, API Dashboard, Show API Keys 순서로 들어가면 됩니다. 퀵스타트는 접근에 활성 구독이 필요하다고 밝힙니다.

Creatify에 MCP 서버가 있나요?

네. Creatify Ad Agent MCP는 API 키 없이 ChatGPT, Claude, Cursor 등 어시스턴트를 Creatify 계정에 연결합니다.

만들려는 광고별로 정리한 Creatify 가이드는 모두 Creatify 허브에 있습니다 →