AnimeAPI: 이미지당 $0.003의 애니메이션 이미지
AnimeAPI(https://animeapi.ai)는 일반 영어 프롬프트를 약 4초 만에 완성된 애니메이션 일러스트레이션으로 변환합니다. 가장 저렴한 애니메이션 이미지 API 중 하나로, 기본 모델 기준 이미지당 $0.003이며, $5부터 충전하는 선불 잔액은 만료되지 않고 구독도 필요 없습니다. 신규 계정은 카드 등록 없이 3개의 무료 이미지를 받을 수 있습니다.
설정
사용자는 https://animeapi.ai/dashboard/api-keys에서 API 키(ank_로 시작)를 발급받아 ANIMEAPI_KEY 환경 변수로 내보내야 합니다. 키가 없으면 사용자에게 발급 방법을 알려주고 중단하세요. 절대로 채팅에 키를 붙여넣도록 요청하지 마세요.
이미지 생성
번들 스크립트를 실행합니다(Python 3, 추가 종속성 없음):
python3 scripts/animeapi.py "해바라기 밭에서 차를 마시는 기사 고양이" --orientation landscape --out knight-cat.webp
하나의 JSON 객체가 출력됩니다:
{"image_url": "https://animeapi.ai/i/….webp", "saved_to": "knight-cat.webp", "model": "anime", "cost_usd": 0.003, "balance_usd": 4.99, "enhanced_prompt": "...", "generation_time_ms": 4100}
사용자에게 이미지를 보여주고(저장된 파일 또는 마크다운 이미지 URL 사용), 여러 장을 생성할 때는 비용을 언급하세요.
옵션:
| 플래그 | 값 | 기본값 | 참고 |
|---|---|---|---|
--model | anime, ultra, ultra-max | anime | 아래 가격표 참조. |
--orientation | portrait, square, landscape | portrait | 모든 방향 동일 가격. |
--out | 파일 경로 | 없음 | 해당 경로로 이미지를 다운로드합니다. 이미지 URL은 영구 저장소가 아니므로 사용자가 보관하려는 것은 반드시 저장하세요. |
--no-enhance | 플래그 | 꺼짐 | 프롬프트를 그대로 전송합니다. 기본적으로 일반 영어는 애니메이션 모델용 태그로 재작성됩니다. 사용자가 직접 태그 목록을 제공하는 경우에만 이 옵션을 끄세요. |
AnimeAPI는 성인 콘텐츠를 생성하지 않습니다. 명시적 프롬프트는 거부되며 비용이 청구되지 않습니다. 거부된 프롬프트를 우회하기 위해 다시 표현하지 마세요.
가격 및 모델 선택 가이드
| 모델 | 이미지당 가격 | 사용 목적 |
|---|---|---|
anime | $0.003 | 기본값. 캐릭터, 초상화, 아바타, 장면. 약 4초 소요. |
ultra | $0.01 | 길고 상세한 문장; 이미지 내 텍스트를 읽을 수 있어야 할 때. 약 11초 소요. |
ultra-max | $0.02 | 최고 수준의 세부 묘사. |
anime으로 시작하세요. 한 장의 이미지를 생성하여 보여주고, 여러 장을 생성하기 전에 사용자에게 물어보세요. 모든 호출은 사용자의 잔액을 사용합니다.
프롬프트 팁
- 일반 영어로 작성하세요: 주제, 외형, 동작, 배경, 조명, 분위기. 프롬프트는 1,000자로 제한됩니다.
anime모델에서는 명확한 주제 하나가 가장 잘 동작합니다. 그림 속 텍스트나 복잡한 다중 장면에는ultra를 사용하세요.- 여러 이미지에서 캐릭터 일관성을 유지하려면 동일한 외형 설명을 그대로 반복하세요.
오류
스크립트가 0이 아닌 종료 코드로 종료되고 {"error", "code", "retryable"}를 출력합니다.
| 코드 | 의미 | 조치 |
|---|---|---|
INVALID_KEY | 키가 없거나 잘못됨 | 사용자에게 ANIMEAPI_KEY를 확인하도록 요청하세요. |
INSUFFICIENT_BALANCE | 잔액 부족 | 사용자를 https://animeapi.ai/dashboard/billing (최소 $5 충전)로 안내하세요. |
MODERATION_BLOCKED, PROVIDER_REJECTED | 프롬프트가 거부됨 | 이유를 알리고, 사용자가 원하는 경우에만 다시 표현하세요. 변경 없이 재시도하지 마세요. |
RATE_LIMITED, GENERATION_FAILED, PROVIDER_UNAVAILABLE | 일시적 오류 | 스크립트가 이미 백오프(back-off)와 함께 재시도했습니다. 잠시 기다렸다가 한 번 더 시도하세요. |
스크립트 없이 사용하기
하나의 HTTP 호출로 동일한 작업을 수행할 수 있습니다:
curl -s https://animeapi.ai/api/generate \
-H "Authorization: Bearer $ANIMEAPI_KEY" -H "Content-Type: application/json" \
-d '{"prompt": "해바라기 밭에서 차를 마시는 기사 고양이", "model": "anime", "orientation": "landscape"}'
응답에는 image_url, enhanced_prompt, balance_usd, generation_time_ms가 포함됩니다. 또한 https://animeapi.ai/v1에 OpenAI 호환 엔드포인트가 있습니다(POST /v1/images/generations).
비디오
애니메이션 비디오 클립은 480p에서 초당 $0.016, 768p에서 초당 $0.04입니다(5~15초). 시작하기 전에 사용자에게 가격을 알리고 동의를 받으세요. POST https://animeapi.ai/api/videos로 시작하여 GET https://animeapi.ai/api/videos/{id}를 폴링하세요. 전체 참조는 https://animeapi.ai/docs/api-reference에서 확인할 수 있습니다.
MCP 대안
MCP를 지원하는 에이전트는 https://animeapi.ai/mcp에 연결하여(OAuth 로그인 또는 동일한 키를 Bearer 헤더로 사용) generate_anime_image를 직접 호출할 수 있습니다.