Popcraft API

모든 주요 AI 모델을 하나의 엔드포인트로.

자체 제품 내에서 이미지, 비디오, 오디오 및 아바타를 생성하세요. Popcraft가 큐잉, 공정성, 재시도 및 청구를 처리하므로, 프롬프트 하나만 보내면 결과를 얻을 수 있습니다.

엔터프라이즈 조직 전용 · 성공적인 생성 건에 대해서만 과금

# 프롬프트 하나로 즉시 작업 ID 반환

POST /v1/images/generations
{
  "model": "nano-banana-2",
  "prompt": "a tiny origami fox on a desk, soft morning light"
}

202 Accepted
{ "id": "job_9f2c1a", "status": "queued", "credits_reserved": 6 }

이미지

텍스트-이미지 및 참조 기반 생성을 프로덕션 해상도로 지원하며, 빠른 초안부터 최고 품질까지 모두 가능합니다.

동영상

명시적인 재생 시간과 해상도를 갖춘 영화 같은 텍스트-비디오 및 이미지-비디오 생성 기능을 제공하며, 초 단위로 가격이 책정되고 사전에 견적이 제공됩니다.

오디오

음성, 효과음 및 음악을 생성합니다. 재생 시간이 명시되어 있어 프레임이 렌더링되기 전에도 정확한 크레딧 견적을 확인할 수 있습니다.

아바타

정지된 인물 사진에 오디오나 텍스트 음성 변환(TTS)을 적용하여 말하는 아바타 비디오를 제작하세요. 호출 한 번으로 클립 하나가 완성됩니다.

프로덕션 환경을 위한 설계

어려운 부분은 이미 해결되었습니다.

생성 작업은 느리고, 몰아서 발생하며, 잘못 처리될 경우 비용이 많이 듭니다. 본 플랫폼은 한 테넌트의 요청 폭주가 다른 테넌트의 단일 작업에 지연을 일으키지 않도록 설계되었습니다.

내장된 유출 탐지 기능

모든 API 키는 볼륨 및 속도 급증과 낯선 국가에서의 접근 여부를 감시합니다. 의심스러운 활동이 감지되면 즉시 소유자에게 알림이 전송되므로, 키 유출 사고를 청구서가 나오기 전 몇 분 만에 차단할 수 있습니다.

제공업체 제한, 완벽 흡수

종류별 동시성 제한과 모델별 속도 예산이 제공업체의 제한 범위 내에서 자동으로 유지되도록 합니다. 백프레셔(backpressure)는 조용히 삭제되는 방식이 아닌, 깔끔한 429 오류로 처리됩니다.

기본적으로 내구성 보장

모든 작업은 수락되는 즉시 영구 저장됩니다. 배포, 재시작, 인스턴스 오류가 발생해도 작업이 손실되거나 이중으로 청구되지 않습니다.

첫 바이트부터 비동기식

제출하면 밀리초 단위로 작업 ID가 반환됩니다. 상태를 폴링하거나, 결과가 준비되는 즉시 웹훅을 통해 결과를 푸시받을 수 있습니다.

서명된 웹훅

터미널 이벤트는 HMAC 서명과 함께 전달되며 실패 시 재시도되므로, 폴링을 완전히 건너뛰어도 결과를 놓치지 않습니다.

실시간 모델 카탈로그

런타임에 사용 가능한 모델, 기능, 제한 사항 및 크레딧 가격을 조회하세요. 새로운 모델은 귀측의 코드 변경 없이 자동으로 나타납니다.

플랜

기본 플랜으로 시작하고, 엔터프라이즈 플랜으로 확장하세요.

복잡한 요금제는 없습니다. 모든 조직은 동일한 합리적인 기본 설정으로 시작하며 생성한 만큼만 비용을 지불합니다. 더 많은 처리량이 필요할 경우, 엔터프라이즈 플랜을 통해 동시성 처리를 우선으로 하여 고객과 함께 제한 수치를 설정합니다.

모든 조직 · 즉시 시작

기본값

구축, 출시 및 셀프 서비스에 필요한 모든 것.

종량제

크레딧 전용 · 약정 없음

동시성이미지 10개 · 비디오 4개 · 오디오 6개 · 아바타 2개 동시 처리
요청 속도60 / 분
대기열 깊이종류별 50개 대기
전송폴링 또는 서명된 웹훅
지출 관리키별 제한 및 조직 전체 한도

문의하기

규모 확장 시 · 협의 필요

Enterprise

동일한 플랫폼에서 모든 제한을 원하는 수치까지 상향합니다.

문의하기

협의된 요금 및 제한

동시성처리량에 맞춰 상향 · 원하는 수치로 설정
사용량 및 용량더 높은 RPM · 모델별 전용 예산
상업용인보이스 결제 · 외상 거래 · SLA
보증보안 검토 · DPA · 전담 엔지니어
지출 관리맞춤형 한도, 소유자 제어 유지

문의하기

협상 가능

동시성 상향은 직접 설정하세요.

기본 수치는 최소 기준일 뿐입니다. Enterprise 플랜에서는 동시 실행 작업 수, 호출 속도, 대기열 깊이 등 모든 항목을 조직별로 설정하고 적용할 수 있습니다. 코드 변경이나 새로운 키 발급은 필요하지 않습니다.

항목	기본값	Enterprise
진행 중인 이미지 작업	10개 동시 처리	상향 문의하기
진행 중인 비디오 작업	4개 동시 처리	상향 문의하기
진행 중인 오디오 작업	6개 동시 처리	상향 문의하기
진행 중인 아바타 작업	2개 동시 처리	상향 문의하기
분당 요청 수	60	상향 문의하기
대기열 깊이	종류별 50개 대기	상향 문의하기
모델별 용량	공유 풀	전용 환경 문의하기
월간 크레딧 한도	직접 설정	상향 문의하기

이는 실제 제어 설정으로, 플랜 변경 시 조직별로 즉시 적용됩니다. 처리량 증가는 마이그레이션이 아닌 상담을 통해 진행됩니다.

지출 및 보안

모든 제어권은 소유자에게 있습니다.

개발자에게 키를 제공한다고 해서 예산까지 넘겨주는 것은 아닙니다. 소유자는 지출 한도를 설정하고 모든 크레딧을 모니터링하며, 문제가 있어 보이는 작업은 티켓을 열 필요 없이 즉시 중단시킬 수 있습니다.

지출 한도 설정

조직 전체의 월간 지출 한도와 각 키별 크레딧 제한을 설정하세요. 두 설정 모두 제출 시점에 적용되므로, 한도를 초과하는 요청은 크레딧이 차감되기 전에 거부됩니다.

부정 사용을 조기에 차단하세요

모든 키는 사용량과 속도 급증, 그리고 낯선 국가에서의 호출 여부를 감시합니다. 키가 유출된 것으로 보이면 즉시 소유자에게 이메일과 콘솔을 통해 알림이 전송되며, 클릭 한 번으로 키를 취소할 수 있습니다.

예상치 못한 청구서 방지

실패, 취소, 시간 초과된 작업은 청구되지 않습니다. 지출 한도와 알림 기능이 있어, 승인하지 않은 비용이 유출된 키로 인해 청구될 일은 없습니다.

결제

시도가 아닌 결과에 대해 비용을 지불하세요.

크레딧은 작업을 제출할 때 예약되며 작업이 완료될 때만 차감됩니다. 실패, 취소, 시간 초과된 작업은 비용이 발생하지 않으므로 환불을 걱정할 필요가 전혀 없습니다.

투명한 사전 견적: 모든 요청은 실행 전 라이브 카탈로그를 기준으로 가격이 책정되며, 상태를 읽을 때마다 예상 잔액이 계산되므로 항상 사용 가능한 예산을 확인할 수 있습니다.

조달 부서의 질문들

사용량은 크레딧으로 측정되며 조직의 월간 주기에 따라 청구됩니다. 개발자별로 지갑이 나뉘지 않고 하나의 잔액을 공유합니다. 모든 요청은 라이브 카탈로그에서 사전에 가격이 책정되며, 작업이 완료될 때만 요금이 부과됩니다. 실패, 취소 또는 시간 초과된 작업에는 비용이 발생하지 않습니다.

네, 두 가지 수준에서 제한됩니다. 주기별 조직 전체 한도와 키별 크레딧 한도가 있어, 단일 통합이 예산을 초과하여 사용하는 것을 방지합니다. 두 제한 모두 제출 시점에 적용되므로, 한도를 초과하는 요청은 크레딧이 차감되기 전에 거부됩니다. 소유자가 두 제한을 모두 제어합니다.

콘솔에서 API 키별 및 팀 멤버별 실시간 사용량을 확인할 수 있으며, 최근 작업 및 요금 내역도 제공됩니다. 원하는 기간에 대해 작업별 또는 모델별로 CSV 명세서를 내출할 수 있습니다. 엔터프라이즈 플랜에서는 순 결제 조건(net terms)이 포함된 월간 청구서가 제공됩니다.

각 모델 종류에는 진행 중인 작업에 대한 제한과 키별 제한, 그리고 제한된 대기열이 있습니다. 공정 스케줄러가 키 간에 라운드 로빈 방식으로 처리하므로, 한 고객이 200개의 작업을 한꺼번에 요청해도 다른 고객의 단일 작업이 지연되지 않습니다. 추가 작업은 실패하지 않고 대기열에 쌓이며, 엔터프라이즈 플랜에서는 처리량에 맞춰 제한이 상향 조정됩니다.

요청은 키별 및 조직별 요금 버킷에 의해 관리됩니다. 기본 수치는 최소 기준이며, 동시성, 요청 속도, 대기열 깊이, 모델별 용량은 모두 조직별로 즉시 재설정할 수 있습니다. 재배포나 새로운 키 발급이 필요하지 않습니다.

백프레셔(backpressure)와 함께 깔끔한 429 오류가 반환되며, 요청이 무시되는 일은 없습니다. 이미 수락된 작업은 대기열을 통해 계속 처리되며, 새로운 제출 요청 속도를 조절하거나 저희에게 한도 상향을 요청하실 수 있습니다.

비동기 방식으로 처리됩니다. 제출 시 밀리초 단위로 작업 ID가 반환됩니다. 이후 생성 엔드포인트를 폴링하거나, 결과가 준비되는 즉시 서명된 웹훅을 통해 결과를 푸시받을 수 있습니다.

최종 이벤트에는 조직별 비밀 키로 검증할 수 있는 HMAC 서명이 포함되어 있으며, 실패 시 재시도됩니다. 따라서 폴링을 완전히 건너뛰어도 결과를 놓칠 염려가 없습니다.

내장된 오남용 탐지 기능이 모든 키의 볼륨 및 속도 급증, 익숙하지 않은 국가에서의 활동을 감시하며, 이상 징후가 발견되는 즉시 이메일과 콘솔을 통해 팀에 알림을 보냅니다. 클릭 한 번으로 키를 취소할 수 있으며, 지출 한도가 설정되어 있어 대응하기 전에도 피해 범위가 제한됩니다.

네. 멤버에게 자체 범위(self-scope)의 콘솔 액세스 권한을 부여할 수 있습니다. 이 경우 멤버는 자신의 키만 관리하고 자신의 사용량만 확인할 수 있으며, 조직의 결제 정보나 다른 멤버의 키는 절대 볼 수 없습니다. 소유자와 관리자는 모든 정보를 확인할 수 있습니다.

API는 조직 단위로 활성화됩니다. 계정 관리자가 기능을 켜고 제한을 설정하면, 이후부터는 소유자가 콘솔에서 키, 문서, 사용량, 결제 정보를 직접 관리할 수 있습니다. 대부분의 팀은 당일에 바로 프로덕션 모델을 호출하여 사용합니다.

시작하기

액세스 권한은 조직별로 부여됩니다.

API는 엔터프라이즈 조직에서 사용할 수 있습니다. 조직의 권한이 활성화되면 소유자와 관리자가 대시보드에서 모든 것을 직접 관리할 수 있습니다.

권한 활성화

계정 관리자가 조직의 API 액세스 권한을 활성화하고 전용 크레딧 풀을 설정합니다.

키 생성 및 문서 확인

콘솔에서 개발자를 위한 범위 지정 API 키를 생성하고, 복사 및 붙여넣기 예제가 포함된 전체 대화형 참조 문서를 확인하세요.

배포하기

제출, 폴링, 렌더링을 수행하세요. 제품이 생성되는 동안 콘솔에서 사용량과 청구 업데이트를 실시간으로 확인하세요.

액세스 요청 가격 보기