AnimGen
가입하기

AnimGen 공개 API · v1

공개 베타

제품에 애니메이션 생성 기능을 통합하세요

공개 베타 비동기 API로 동영상과 게임용 애니메이션 에셋을 만드세요. 이메일 인증을 마친 계정은 키를 만들 수 있으며 웹 앱과 같은 계정 크레딧을 사용합니다.

개발자 센터 열기API 빠른 시작 읽기OpenAPI 3.1 다운로드

공식 원격 MCP

공개 베타

Perplexity, Claude, Codex 등에서 AnimGen 사용

API 키를 복사하지 않고 OAuth로 Perplexity 또는 호환 MCP 클라이언트에 AnimGen 계정 접근을 허용하세요. 클라이언트에서 모델 검색, 이미지 업로드, 비용 견적, 애니메이션 생성 및 본인 소유 결과 다운로드를 할 수 있습니다.

https://api.animgen.com/mcp

PKCE를 사용하는 OAuth 2.1

AnimGen에 로그인해 권한을 검토하세요. 계정 센터에서 연결된 앱의 권한을 언제든 철회할 수 있습니다.

명시적 지출 보호

연결만으로는 크레딧이 사용되지 않습니다. 유료 생성에는 유효기간이 짧은 견적 또는 최대 크레딧 한도가 필요합니다.

Claude에 연결

AnimGen 서버 이름과 URL이 미리 입력된 Claude가 열립니다. 연결 정보와 요청 권한을 확인한 뒤 승인하세요.

Perplexity에 연결

원격 MCP 커넥터 가이드를 따르세요. 이용 가능 여부는 Perplexity 요금제와 조직 설정에 따라 다릅니다.

MCP 워크플로와 제공 상태 보기실제 운영 환경의 전체 MCP 생성 사례 보기

API 워크플로

한 번의 요청으로 애니메이션 결과까지

파일 ID, 인라인 Base64 이미지 또는 공개 HTTPS 이미지 URL을 전송하고 반환된 애니메이션이 최종 상태가 될 때까지 조회하세요.

서버 측 인증

Bearer 헤더에 ag_live_ API 키를 사용하세요. 브라우저 번들, 모바일 앱 또는 배포되는 게임 클라이언트에 키를 넣지 마세요.

기본 비동기 처리

생성 요청은 202와 Retry-After를 반환합니다. 약 5초마다 리소스 URL을 조회하고 재시도할 때 같은 Idempotency-Key를 사용하세요.

공유 크레딧과 명확한 한도

API는 같은 계정 잔액을 사용합니다. 기본 등록 계정은 동시 작업 1개, 대기 작업 3개, 분당 생성 요청 3회 및 기타 요청 60회로 시작합니다. 구독하면 계정 전체에 적용되는 한도가 늘어납니다.

기본 동작

  • selection을 생략하면 생성된 전체 동영상을 사용합니다.
  • output_formats를 생략하면 스프라이트 시트를 만듭니다.
  • 투명 내보내기는 Alpha Key 방식만 사용합니다. API가 임의의 배경을 제거하지는 않습니다.
  • 유효한 Base64는 작업이 접수되기 전에 저장됩니다.
  • 후속 단계가 실패해도 이미 만들어진 결과는 유지됩니다.
투명 PNG 및 알파 내보내기 과정
원클릭 cURL
이 예제는 기본값을 사용하기 위해 selection과 export.output_formats를 생략했습니다.
curl -X POST https://api.animgen.com/v1/animations \
  -H "Authorization: Bearer ag_live_REPLACE_ME" \
  -H "Idempotency-Key: character-run-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "first_frame": {
        "type": "base64",
        "media_type": "image/png",
        "data": "<BASE64_DATA>"
      }
    },
    "prompt": "pixel art knight running, side view",
    "metadata": {"external_id": "character-run-v1"}
  }'

주요 리소스

POST/animations한 번의 요청으로 동영상 생성 및 애니메이션 내보내기
GET/animations/{id}상태, 크레딧, 오류 및 출력 에셋 조회
POST/video-generations동영상 미리보기 별도 생성
POST/animation-exports선택한 동영상 에셋 별도 내보내기
POST/files재사용 가능한 PNG, JPEG, WebP 입력 업로드
GET/models현재 모델 기능과 유효한 설정값 확인

고급 2단계 흐름

생성과 내보내기 사이에 검토 또는 편집 단계가 필요하면 /video-generations와 /animation-exports를 따로 사용하세요.

안전한 재시도

429 또는 재시도 가능한 503 응답은 Retry-After 이후에 다시 시도하세요. 같은 논리적 생성 작업에 새 멱등성 키를 만들지 마세요.

출력

스프라이트 시트, 메타데이터, PNG 프레임, 동영상 클립 및 Unity·Godot·Unreal Paper2D·Cocos Creator 패키지는 다운로드 가능한 Asset 객체로 제공됩니다. 투명 출력에는 Alpha Key 원본이 필요하며, 상업적 이용에는 약관에 따른 유료 이용 권한이 필요합니다.

통합할 준비가 되셨나요?

이메일을 인증하고 계정 센터에서 키를 만든 뒤 원클릭 엔드포인트로 시작하세요. 더 높은 한도가 필요하면 구독할 수 있습니다.

개발자 센터 열기더 높은 한도 비교