인증 및 이미지 입력

신뢰할 수 있는 환경에서 인증

공개 API 요청에 Authorization: Bearer <API_KEY>를 사용하세요. 키 원문은 계정 → 개발자에서 생성할 때만 표시됩니다. 비밀 저장소에 보관하고 교체 시 호출자를 먼저 갱신한 뒤 이전 키를 폐기하세요. 요청 헤더를 로그에 남기지 마세요.

인증된 AnimGen 계정이 필요합니다. 등록 계정은 동시 작업 1개, 대기열 3개, 분당 생성 3회 및 기타 요청 60회로 시작합니다. 활성 구독은 계정 전체 한도를 높입니다. 현재 등급·키 권한·한도는 GET /account, 가용 크레딧은 GET /credits/balance에서 확인하세요.

MCP는 OAuth와 더 세분화된 별도 권한을 사용합니다. 이 표를 MCP에 적용하지 마세요.

방법 A: 한 번 업로드하고 파일 ID 재사용

curl --fail-with-body https://api.animgen.com/v1/files \
  -H "Authorization: Bearer $ANIMGEN_API_KEY" \
  -F "[email protected]"

응답에는 id, MIME, 크기, 바이트 수, SHA-256이 있습니다. 스튜디오 uploadId, 파일 경로, 내부 작업 식별자가 아닌 반환 ID를 사용하세요.

{
  "input": {
    "first_frame": {
      "type": "file",
      "file_id": "00000000-0000-4000-8000-000000000001"
    }
  }
}

위 UUID는 플레이스홀더입니다. PNG, JPEG, WebP를 받으며 기본 multipart 한도는 20MB입니다. 디코딩된 이미지와 크기도 검증합니다. 이름·MIME 선언을 신뢰하기보다 반환된 한도 오류를 처리하세요.

방법 B: 인라인 Base64

{
  "type": "base64",
  "media_type": "image/png",
  "data": "<PURE_BASE64_IMAGE_BYTES>"
}

data:image/...;base64, 접두사 없이 순수 Base64를 사용하세요. 디코딩 후 한도는 이미지당 10MB, 요청의 인라인 이미지 총 20MB입니다. JSON/Base64 전송은 원본보다 큽니다. 크거나 반복 사용할 이미지는 재사용 업로드를 이용하세요.

Base64 콘텐츠는 생성 접수 전에 저장됩니다. 멱등 요청 재시도 시 동일 바이트를 유지하세요.

방법 C: 공개 HTTPS URL

{
  "type": "url",
  "url": "https://your-public-image-host.example/character.png"
}

예제 호스트를 접근 가능한 실제 이미지 URL로 바꾸세요. 서버가 브라우저 쿠키 없이 이미지를 가져올 수 있어야 합니다. 공개 HTTPS 443 포트만 허용하며 내장 인증 정보·프래그먼트는 사용할 수 없습니다. 사설, 루프백, 링크 로컬 주소가 차단되며 리디렉션 대상도 검사됩니다.

견적·생성 동안 URL의 바이트를 유지하세요. 사설 인트라넷 주소나 로그인 페이지 URL을 쓰지 마세요. 서명 입력 URL은 민감하며 만료될 수 있습니다.

선택 모델에 맞추기

모든 생성에는 첫 프레임이 필요합니다. 마지막 프레임·추가 참조는 현재 모델이 해당 모드를 지원할 때만 허용됩니다. 스키마 전체 최대값이 더 작은 모델별 한도를 덮어쓰지는 않습니다.

GET /models로 모드·설정을 확인하고 전체 요청의 견적을 받은 뒤 생성하세요. 투명 원본은 투명 애니메이션, 이후는 빠른 시작을 참고하세요.