# KovAPI - 전체 레퍼런스 (llms-full.txt)

> KovAPI(이전 이름 NezhaGate)는 OpenAI 호환 AI 모델 게이트웨이입니다. 엔드포인트 하나와 API 키 하나로 GPT, Claude, Gemini, Grok, DeepSeek, Kimi, GLM, Qwen 채팅 모델과 이미지·영상 생성 모델(Seedance, Veo, Wan, MiniMax H3, Nano Banana, GPT Image)을 모두 쓸 수 있습니다. USD 기준으로 사용한 만큼만 결제하며, 실패한 요청에는 과금하지 않습니다. Base URL: https://kovapi.com/v1. 최종 업데이트: 2026-10-26.

아래의 모든 가격은 이 파일이 생성되는 시점에 과금 테이블에서 실시간으로 읽어 온 값입니다. 공식 정가에는 저희가 확인한 날짜를 함께 적었고, 절약률은 저희 가격이 공식가보다 낮은 경우에만 표시합니다. 실측 수치는 실제 고객 호출에서 집계하며, 표본이 충분할 때만 싣습니다.

```
base_url: https://kovapi.com/v1
Authorization: Bearer <YOUR_API_KEY>
```

## 핵심 정보
- API: OpenAI 호환. 채팅은 POST https://kovapi.com/v1/chat/completions 및 /v1/responses, 이미지는 /v1/images/generations 및 /v1/images/edits, 영상은 /v1/videos/generations를 사용합니다. 이미지와 영상은 비동기 작업이므로 제출한 뒤 GET /v1/images/jobs/{id} 또는 /v1/videos/jobs/{id}를 폴링합니다. Claude 모델은 Anthropic Messages API(https://kovapi.com/anthropic/v1/messages)로도 제공됩니다.
- 과금: 채팅은 입력 / 출력 100만 토큰당, 캐시 읽기는 입력 단가의 10%로 과금합니다. 이미지는 해상도별 장당, 영상은 출력 1초당(Grok Imagine Video 1.5, Seedance 2.5 · Special, Seedance 2.0 · Clip, Veo 3.1 모델은 건당) 과금합니다. 실패한 요청에는 비용이 들지 않으며, 이미지·영상 작업은 제출 시 크레딧을 예치하고 실패하면 전액 환불합니다.
- 충전: WeChat Pay는 CNY 10부터, USDT와 은행 카드는 $5부터 가능합니다. $1 = 200 크레딧이며 크레딧은 만료되지 않습니다. 사용하지 않은 충전액은 7일 이내에 환불받을 수 있습니다(수수료: 2026-10-29 이후 충전은 $1.40, 이전은 $0.40). 큰 패키지에는 크레딧이 추가로 지급됩니다: $50: 카드/USDT/WeChat Pay +3%; $500: 카드/USDT +7%; $1,250: 카드 +10%, USDT +12%.
- 가용성: 최근 30일간 외부 점검의 98.11%에 공개 API가 정상 응답했습니다(2분마다 1회 점검). 모델별 실시간 상태는 https://kovapi.com/ko/status에서 확인할 수 있습니다.
- 자동 재시도: 요청이 오류나 시간 초과를 만나거나 용량이 가득 차면, 출력이 스트리밍되기 전에 자동으로 재시도하며 두 번 과금하지 않습니다.
- 요청 제한: 계정별 기본 한도는 없습니다. 한 모델이 가득 차면 API가 Retry-After와 함께 429를 반환합니다. 키별 RPM, 일일 예산, 총 사용 한도, 모델·IP 허용 목록은 직접 설정할 수 있습니다.
- 데이터: 호출 로그는 콘솔에 60일간 보관되고, 로그의 텍스트 내용은 30일 후, 생성된 이미지와 영상은 15일 후, 업로드한 참조 파일은 7일 후 삭제됩니다. 콘텐츠는 학습에 사용하지 않습니다.
- 고객지원: support@kovapi.com, Telegram https://t.me/+-erBoH9-AYY4MTM1, WeChat. 베이징 시간 10:00-19:00에 운영하며 1시간 이내에 답변합니다.

## 채팅 모델 (실시간 가격, 100만 토큰당 USD)
- [GPT-5.6 Sol](https://kovapi.com/ko/model/gpt-5.6-sol): OpenAI. 입력 $1.20 / 출력 $6.00, 캐시 읽기 $0.12. 공식가 $4.00 / $20.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 70% 절약. 프런티어 추론, 에이전트 코딩, 장기 과제, 구조화 출력. 약 272K 토큰(GPT-5 제품군 컨텍스트 창. 시스템 프롬프트 등 부가 입력도 이 창에 포함됩니다). 최근 7일 실제 고객 호출 실측: 성공률 98.3%. 첫 토큰 지연 p50 6.2 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/gpt-5.6-sol.
- [GPT-5.6 Luna](https://kovapi.com/ko/model/gpt-5.6-luna): OpenAI. 입력 $0.07 / 출력 $0.40, 캐시 읽기 $0.007. 공식가 $0.20 / $1.20 (개발사 정가, 2026-10-02 확인), 공식가 대비 65% / 66% 절약. 고속 채팅, 에이전트 코딩, 대량 · 저지연 처리, 구조화 출력. 약 272K 토큰(GPT-5 제품군 컨텍스트 창. 시스템 프롬프트 등 부가 입력도 이 창에 포함됩니다). 최근 30일 실제 고객 호출 실측: 성공률 92.7%. 문서: https://docs.kovapi.com/ko/gpt-5.6-luna.
- [GPT-6 Astra](https://kovapi.com/ko/model/gpt-6-astra): OpenAI. 입력 $3.00 / 출력 $15.00, 캐시 읽기 $0.30. 공식가 $10.00 / $50.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 70% 절약. 심층 추론, 에이전트 코딩, 초장문 컨텍스트, 이미지 입력, 구조화 출력. 1,050,000 토큰(OpenAI 공표값). 호출당 출력은 최대 128,000 토큰입니다. 시스템 프롬프트 등 부가 입력도 이 창에 포함됩니다. 최근 7일 실제 고객 호출 실측: 성공률 99.2%. 첫 토큰 지연 p50 7.4 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/gpt-6-astra.
- [GPT-6.1 Sol](https://kovapi.com/ko/model/gpt-6.1-sol): OpenAI. 입력 $0.60 / 출력 $3.00, 캐시 읽기 $0.06. 공식가 $2.00 / $10.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 70% 절약. 에이전트 코딩, 복잡한 코딩, 전문 문서·분석 업무, 추론, 초장문 컨텍스트, 이미지 입력, 구조화 출력. 1,050,000 토큰(OpenAI 공표값). 호출당 출력은 최대 128,000 토큰입니다. 시스템 프롬프트 등 부가 입력도 이 창에 포함됩니다. 최근 7일 실제 고객 호출 실측: 성공률 91.2%. 첫 토큰 지연 p50 8.3 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/gpt-6.1-sol.
- [GPT-6 Sol](https://kovapi.com/ko/model/gpt-6-sol): OpenAI. 입력 $0.60 / 출력 $3.00, 캐시 읽기 $0.06. 공식가 $2.00 / $10.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 70% 절약. 복잡한 코딩, 에이전트 워크플로, 추론, 초장문 컨텍스트, 이미지 입력, 구조화 출력. 1,050,000 토큰(OpenAI 공표값). 호출당 출력은 최대 128,000 토큰입니다. 시스템 프롬프트 등 부가 입력도 이 창에 포함됩니다. 최근 7일 실제 고객 호출 실측: 성공률 94.2%. 첫 토큰 지연 p50 4.8 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/gpt-6-sol.
- [GPT-6 Luna](https://kovapi.com/ko/model/gpt-6-luna): OpenAI. 입력 $0.07 / 출력 $0.40, 캐시 읽기 $0.007. 공식가 $0.10 / $0.50 (개발사 정가, 2026-10-02 확인), 공식가 대비 30% / 20% 절약. 대량 채팅, 저지연 에이전트 단계, 분류와 추출, 초장문 컨텍스트, 구조화 출력. 1,050,000 토큰(OpenAI 공표값). 호출당 출력은 최대 128,000 토큰입니다. 시스템 프롬프트 등 부가 입력도 이 창에 포함됩니다. 최근 7일 실제 고객 호출 실측: 성공률 93.7%. 첫 토큰 지연 p50 3.2 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/gpt-6-luna.
- [Claude Sonnet 4.6](https://kovapi.com/ko/model/claude-sonnet-4-6): Anthropic. 입력 $1.50 / 출력 $7.50, 캐시 읽기 $0.15. 공식가 $3.00 / $15.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 50% 절약. 채팅, 코드, 추론, 긴 컨텍스트. 약 200K 토큰. 최근 7일 실제 고객 호출 실측: 성공률 100%. 첫 토큰 지연 p50 3.1 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/claude-sonnet-4-6.
- [Claude Opus 5](https://kovapi.com/ko/model/claude-opus-5): Anthropic. 입력 $4.00 / 출력 $20.00, 캐시 읽기 $0.40. 공식가 $5.00 / $25.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 20% 절약. 심층 추론, 코드, 에이전트, 긴 컨텍스트, 이미지 이해. 약 200K 토큰. 첫 토큰 지연 p50 6.2 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/claude-opus-5.
- [Claude Fable 5](https://kovapi.com/ko/model/claude-fable-5): Anthropic. 입력 $8.00 / 출력 $40.00, 캐시 읽기 $0.80. 공식가 $10.00 / $50.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 20% 절약. 중국어 글쓰기, 서사 창작, 장문 생성, 채팅, 코드, 이미지 이해. 약 200K 토큰. 첫 토큰 지연 p50 6.2 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/claude-fable-5.
- [Claude Opus 5.5](https://kovapi.com/ko/model/claude-opus-5-5): Anthropic. 입력 $2.50 / 출력 $12.50, 캐시 읽기 $0.125. 공식가 $4.00 / $20.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 37% 절약. 복잡한 추론, 장시간 에이전트 코딩, 코드 엔지니어링, 도구 호출, 이미지와 PDF 이해. 1,000,000 토큰(100만, Anthropic 공개 수치). 요청당 최대 128,000 토큰까지 출력합니다. 최근 30일 실제 고객 호출 실측: 성공률 89.1%. 문서: https://docs.kovapi.com/ko/claude-opus-5-5.
- [Claude Sonnet 5.5](https://kovapi.com/ko/model/claude-sonnet-5-5): Anthropic. 입력 $1.50 / 출력 $7.50, 캐시 읽기 $0.15. 공식가 $2.00 / $10.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 25% 절약. 일상 코딩과 에이전트, 긴 컨텍스트, 도구 호출, 이미지와 PDF 이해, 대규모 프로덕션 트래픽. 1,000,000 토큰(100만, Anthropic 공개 수치). 요청당 최대 128,000 토큰까지 출력합니다. 최근 7일 실제 고객 호출 실측: 성공률 98.5%. 문서: https://docs.kovapi.com/ko/claude-sonnet-5-5.
- [Gemini 4 Argon](https://kovapi.com/ko/model/gemini-4-argon): Google. 입력 $0.50 / 출력 $3.00, 캐시 읽기 $0.05. 공식가 $2.00 / $10.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 75% / 70% 절약. Beta · 추론 · 긴 컨텍스트. 약 1,000,000 토큰(백만 단위 롱 컨텍스트). 최근 30일 실제 고객 호출 실측: 성공률 52.1%. 문서: https://docs.kovapi.com/ko/gemini-4-argon.
- [Gemini 3.1 Pro](https://kovapi.com/ko/model/gemini-3.1-pro): Google. 입력 $0.50 / 출력 $3.00, 캐시 읽기 $0.05. 공식가 $2.00 / $12.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 75% 절약. 채팅, 추론, 초장문 컨텍스트, 멀티모달. 약 1,000,000 토큰(백만 단위 롱 컨텍스트). 최근 30일 실제 고객 호출 실측: 성공률 99.7%. 문서: https://docs.kovapi.com/ko/gemini-3.1-pro.
- [Gemini 3.8 Flash](https://kovapi.com/ko/model/gemini-3.8-flash): Google. 입력 $0.60 / 출력 $3.60, 캐시 읽기 $0.06. 공식가 $0.75 / $3.75 (개발사 정가, 2026-10-02 확인), 공식가 대비 20% / 4% 절약. 채팅, 추론, 적응형 사고, 이미지 입력, 초장문 컨텍스트. 약 1,000,000 토큰(백만 단위 롱 컨텍스트). 최근 7일 실제 고객 호출 실측: 성공률 100%. 첫 토큰 지연 p50 10.1 초 (주간 실측, 2026-10-27). 문서: https://docs.kovapi.com/ko/gemini-3.8-flash.
- [DeepSeek V4.1 Flash](https://kovapi.com/ko/model/deepseek-v4.1-flash): DeepSeek. 입력 $0.075 / 출력 $0.30, 캐시 읽기 $0.0015. 공식가 $0.15 / $0.60 (개발사 정가, 2026-10-02 확인), 공식가 대비 50% 절약. 채팅, 추론, 코딩, 도구 호출, 사고 모드 전환. 최근 7일 실제 고객 호출 실측: 성공률 99.6%. 문서: https://docs.kovapi.com/ko/deepseek-v4.1-flash.
- [DeepSeek V4 Flash 0731](https://kovapi.com/ko/model/deepseek-v4-flash-0731): DeepSeek. 입력 $0.13 / 출력 $0.51, 캐시 읽기 $0.004. 공식가 $0.15 / $0.60 (개발사 정가, 2026-10-02 확인), 공식가 대비 13% / 15% 절약. 채팅, 추론, 코딩, 도구 호출, 사고 모드 전환, 버전 고정. 최근 30일 실제 고객 호출 실측: 성공률 99.5%. 문서: https://docs.kovapi.com/ko/deepseek-v4-flash-0731.
- [GLM-5.3](https://kovapi.com/ko/model/glm-5.3): Z.ai. 입력 $1.12 / 출력 $3.52, 캐시 읽기 $0.21. 공식가 $1.40 / $4.40 (개발사 정가, 2026-10-02 확인), 공식가 대비 20% 절약. 채팅, 코딩, 에이전트 워크플로, 추론, 중국어 · 영어 글쓰기, 도구 호출. 최근 7일 실제 고객 호출 실측: 성공률 100%. 문서: https://docs.kovapi.com/ko/glm-5.3.
- [Qwen3.8 Max](https://kovapi.com/ko/model/qwen3.8-max): Alibaba. 입력 $1.40 / 출력 $4.20, 캐시 읽기 $0.175. 공식가 $2.00 / $6.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 30% 절약. 추론, 코딩, 에이전트와 도구 호출, 중국어 · 영어 글쓰기, 이미지 이해. 문서: https://docs.kovapi.com/ko/qwen3.8-max.
- [Qwen3.8 Flash](https://kovapi.com/ko/model/qwen3.8-flash): Alibaba. 입력 $0.10 / 출력 $0.33, 캐시 읽기 $0.012. 공식가 $0.15 / $0.47 (개발사 정가, 2026-10-02 확인), 공식가 대비 33% / 29% 절약. 대량 채팅, 분류와 추출, 요약과 재작성, 이미지 이해와 OCR, 도구 호출. 최근 30일 실제 고객 호출 실측: 성공률 99.1%. 문서: https://docs.kovapi.com/ko/qwen3.8-flash.
- [Grok 4.7](https://kovapi.com/ko/model/grok-4.7): xAI. 입력 $0.30 / 출력 $0.90, 캐시 읽기 $0.075. 공식가 $2.00 / $6.00 (개발사 정가, 2026-10-02 확인), 공식가 대비 85% 절약. 복잡한 추론, 코딩, 긴 문서 분석, 도구 호출, 구조화 출력, 이미지 이해. 최근 7일 실제 고객 호출 실측: 성공률 87.9%. 문서: https://docs.kovapi.com/ko/grok-4.7.

## 이미지 모델 (실시간 가격, 장당 USD)
- [GPT Image 2](https://kovapi.com/ko/model/gpt-image-2): OpenAI. $0.005 (1K) / $0.025 (2K) / $0.04 (4K) (장당). 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 99.8%, 이미지당 중앙값 23 초 (p90 40 초). 업체별 가격 비교: https://kovapi.com/ko/compare/gpt-image. 문서: https://docs.kovapi.com/ko/gpt-image-2.
- [GPT Image 2.5 Flare](https://kovapi.com/ko/model/gpt-image-2.5-flare): OpenAI. $0.005 (1K) / $0.03 (2K) / $0.05 (4K) (장당). 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 99.8%, 이미지당 중앙값 24 초 (p90 39 초). 업체별 가격 비교: https://kovapi.com/ko/compare/gpt-image. 문서: https://docs.kovapi.com/ko/gpt-image-2.5-flare.
- [GPT Image 2.5 Sunburst](https://kovapi.com/ko/model/gpt-image-2.5-sunburst): OpenAI. $0.005 (1K) / $0.03 (2K) / $0.05 (4K) (장당). 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 99.2%, 이미지당 중앙값 26 초 (p90 43 초). 문서: https://docs.kovapi.com/ko/gpt-image-2.5-sunburst.
- [Nano Banana 2](https://kovapi.com/ko/model/nano-banana-2): Google. $0.015 (1K) / $0.025 (2K) / $0.04 (4K) (장당). 공식가 $0.067 / $0.101 / $0.151 (개발사 정가, 2026-10-02 확인), 공식가 대비 77% / 75% / 73% 절약. 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 100%, 이미지당 중앙값 13 초 (p90 30 초). 업체별 가격 비교: https://kovapi.com/ko/compare/nano-banana. 문서: https://docs.kovapi.com/ko/nano-banana-2.
- [Nano Banana Pro](https://kovapi.com/ko/model/nano-banana-pro): Google. $0.02 (1K) / $0.03 (2K) / $0.05 (4K) (장당). 공식가 $0.134 / $0.134 / $0.24 (개발사 정가, 2026-10-02 확인), 공식가 대비 85% / 77% / 79% 절약. 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 100%, 이미지당 중앙값 34 초 (p90 62 초). 업체별 가격 비교: https://kovapi.com/ko/compare/nano-banana. 문서: https://docs.kovapi.com/ko/nano-banana-pro.
- [Nano Banana 2.1](https://kovapi.com/ko/model/nano-banana-2.1): Google. $0.015 (1K) / $0.025 (2K) / $0.04 (4K) (장당). 공식가 $0.0336 / $0.0504 / $0.0756 (개발사 정가, 2026-10-02 확인), 공식가 대비 55% / 50% / 47% 절약. 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 100%, 이미지당 중앙값 30 초 (p90 58 초). 문서: https://docs.kovapi.com/ko/nano-banana-2.1.
- [Grok Imagine Image](https://kovapi.com/ko/model/grok-imagine-image): xAI. $0.005 (1K) / $0.005 (2K) (장당). 공식가 $0.02 / $0.02 (개발사 정가, 2026-10-02 확인), 공식가 대비 75% 절약. 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 98%, 이미지당 중앙값 15 초 (p90 20 초). 문서: https://docs.kovapi.com/ko/grok-imagine-image.
- [Grok Imagine Image Quality](https://kovapi.com/ko/model/grok-imagine-image-quality): xAI. $0.01 (1K) / $0.01 (2K) (장당). 공식가 $0.05 / $0.07 (개발사 정가, 2026-10-02 확인), 공식가 대비 80% / 85% 절약. 텍스트-투-이미지와 이미지 편집(/v1/images/edits). 최근 7일 실제 고객 호출 실측: 성공률 91.2%, 이미지당 중앙값 14 초 (p90 18 초). 문서: https://docs.kovapi.com/ko/grok-imagine-image-quality.

## 영상 모델 (실시간 가격, USD)
- [Veo 3.1](https://kovapi.com/ko/model/veo-3.1): Google. 720p $0.20 (건당), 1080p $0.22 (건당). 클립당 8초 고정. 참조 이미지 최대 3장. 첫 프레임, 첫/마지막 프레임 또는 피사체 참조. 네이티브 오디오 항상 켜짐. 업체별 가격 비교: https://kovapi.com/ko/compare/veo. 문서: https://docs.kovapi.com/ko/veo-3.1.
- [Gemini Omni Flash](https://kovapi.com/ko/model/gemini-omni-flash): Google. 720P $0.05/초, 1080P $0.05/초. 클립당 6 / 8 / 10초. 참조 이미지 최대 3장. 첫 프레임, 첫/마지막 프레임 또는 피사체 참조. 프롬프트 최대 20,000자. 네이티브 오디오 항상 켜짐. 업체별 가격 비교: https://kovapi.com/ko/compare/veo. 문서: https://docs.kovapi.com/ko/gemini-omni-flash.
- [Seedance 2.5 · Token](https://kovapi.com/ko/model/seedance-2.5-token): ByteDance. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 문서: https://docs.kovapi.com/ko/seedance-2.5-token.
- [Seedance 2.5 · Token Draft](https://kovapi.com/ko/model/seedance-2.5-token-draft): ByteDance. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 문서: https://docs.kovapi.com/ko/seedance-2.5-token-draft.
- [Seedance 2.5](https://kovapi.com/ko/model/seedance-2.5): ByteDance. 480P $0.10/초, 720P $0.158/초, 1080P $0.33/초. 공식가 480P $0.103/초, 720P $0.231/초 (개발사 정가, 2026-10-02 확인), 공식가 대비 480P 2%, 720P 31% 절약. 클립당 4-30초. 참조 이미지 최대 30장. 참조 영상 10개(합계 30초 이내). 참조 오디오 10개. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 프롬프트 최대 11,000자. 네이티브 오디오 항상 켜짐. 참조 영상은 과금하지 않음. 최근 7일 실제 고객 호출 실측: 성공률 84.5%, 클립당 중앙값 8 분 (p90 20.1 분). 업체별 가격 비교: https://kovapi.com/ko/compare/seedance. 문서: https://docs.kovapi.com/ko/seedance-2.5.
- [Seedance 2.0](https://kovapi.com/ko/model/seedance-2.0): ByteDance. 720P $0.15/초, 1080P $0.30/초 (480P 출시 예정). 공식가 720P $0.151/초, 1080P $0.374/초 (개발사 정가, 2026-10-02 확인), 공식가 대비 1080P 19% 절약. 클립당 5-15초. 참조 이미지 최대 9장. 참조 영상 3개(합계 15초 이내). 참조 오디오 3개. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 네이티브 오디오 항상 켜짐. 참조 영상은 과금하지 않음. 최근 30일 실제 고객 호출 실측: 성공률 64.4%, 클립당 중앙값 4.8 분 (p90 7.2 분). 업체별 가격 비교: https://kovapi.com/ko/compare/seedance. 문서: https://docs.kovapi.com/ko/seedance-2.0.
- [Seedance 2.0 Fast](https://kovapi.com/ko/model/seedance-2.0-fast): ByteDance. 480P $0.046/초, 720P $0.075/초. 공식가 480P $0.054/초, 720P $0.121/초 (개발사 정가, 2026-10-02 확인), 공식가 대비 480P 14%, 720P 38% 절약. 클립당 5-15초. 참조 이미지 최대 9장. 참조 영상 3개(합계 15초 이내). 참조 오디오 3개. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 네이티브 오디오 항상 켜짐. 참조 영상은 과금하지 않음. 업체별 가격 비교: https://kovapi.com/ko/compare/seedance. 문서: https://docs.kovapi.com/ko/seedance-2.0-fast.
- [Seedance 2.0 Mini](https://kovapi.com/ko/model/seedance-2.0-mini): ByteDance. 480P $0.022/초, 720P $0.046/초. 클립당 5-15초. 참조 이미지 최대 9장. 참조 영상 3개(합계 15초 이내). 참조 오디오 3개. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 네이티브 오디오 항상 켜짐. 참조 영상은 과금하지 않음. 문서: https://docs.kovapi.com/ko/seedance-2.0-mini.
- [Seedance 2.0 · Clip](https://kovapi.com/ko/model/seedance-2.0-clip): ByteDance. 720P $1.00 (건당). 클립당 5 / 10 / 15초. 참조 이미지 최대 9장. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 네이티브 오디오 항상 켜짐. 문서: https://docs.kovapi.com/ko/seedance-2.0-clip.
- [Seedance 2.5 · Special](https://kovapi.com/ko/model/seedance-2.5-30s): ByteDance. 720P $2.00 (건당). 공식가 $6.93 (건당) (개발사 정가, 2026-10-02 확인), 공식가 대비 71% 절약. 클립당 4-30초. 참조 이미지 최대 30장. 참조 오디오 10개. 이미지는 모두 참조 이미지(@Image1, @Image2 ...)로 쓰이며 첫 프레임 지정 불가. 네이티브 오디오 항상 켜짐. 최근 7일 실제 고객 호출 실측: 성공률 65%, 클립당 중앙값 12.8 분 (p90 63.5 분). 업체별 가격 비교: https://kovapi.com/ko/compare/seedance. 문서: https://docs.kovapi.com/ko/seedance-2.5-30s.
- [Wan 3.0](https://kovapi.com/ko/model/wan3.0-video): Alibaba. 480P $0.04/초, 720P $0.065/초, 1080P $0.13/초. 공식가 480P $0.05/초, 720P $0.10/초, 1080P $0.20/초 (개발사 정가, 2026-10-02 확인), 공식가 대비 480P 20%, 720P 35%, 1080P 35% 절약. 클립당 4-30초. 참조 이미지 최대 10장. 참조 영상 5개(합계 15초 이내). 첫 프레임, 첫/마지막 프레임 또는 피사체 참조. 오디오 켜기/끄기 옵션 없음. 참조 영상 길이(초)도 과금. 최근 30일 실제 고객 호출 실측: 성공률 60.9%, 클립당 중앙값 3.5 분 (p90 7.2 분). 업체별 가격 비교: https://kovapi.com/ko/compare/wan. 문서: https://docs.kovapi.com/ko/wan3.0-video.
- [Wan 3.0 Prime](https://kovapi.com/ko/model/wan3.0-video-prime): Alibaba.  (480P 출시 예정, 720P 출시 예정, 1080P 출시 예정). 클립당 4-30초. 참조 이미지 최대 10장. 참조 영상 5개(합계 15초 이내). 첫 프레임, 첫/마지막 프레임 또는 피사체 참조. 오디오 켜기/끄기 옵션 없음. 참조 영상 길이(초)도 과금. 업체별 가격 비교: https://kovapi.com/ko/compare/wan. 문서: https://docs.kovapi.com/ko/wan3.0-video-prime.
- [MiniMax H3](https://kovapi.com/ko/model/minimax-h3): MiniMax. 1080P $0.036/초. 공식가 768P $0.08/초, 2K $0.13/초 (개발사 정가, 2026-10-02 확인; 1080P 등급 없음), 768P 대비 55% 절약. 클립당 5-15초. 참조 이미지 최대 5장. 참조 오디오 3개. 기본은 첫 프레임 모드, 여러 장 참조는 image_role=reference. 최근 30일 실제 고객 호출 실측: 성공률 92%, 클립당 중앙값 4.6 분 (p90 13.6 분). 업체별 가격 비교: https://kovapi.com/ko/compare/minimax-h3. 문서: https://docs.kovapi.com/ko/minimax-h3.
- [Grok Imagine Video 1.5](https://kovapi.com/ko/model/grok-imagine-video-1.5): xAI. 480P $0.30 (건당), 720P $0.40 (건당). 클립당 4-15초. 참조 이미지 최대 7장. 네이티브 오디오 항상 켜짐. 최근 7일 실제 고객 호출 실측: 성공률 63.2%, 클립당 중앙값 81 초 (p90 101 초). 문서: https://docs.kovapi.com/ko/grok-imagine-video-1.5.

## 출시 예정 (아직 호출 불가)
- [Claude Haiku 5.5](https://kovapi.com/ko/model/claude-haiku-5-5): 출시 예정; Claude Haiku 5.5 API: Anthropic 역대 가장 빠르고 저렴하며 성능이 뛰어난 소형 모델. 100만 토큰 컨텍스트, Haiku 최초의 effort 조절, 공식 단가는 Haiku 4.5보다 최대 90% 저렴
- [Claude Fable 5.1](https://kovapi.com/ko/model/claude-fable-5-1): 출시 예정; Anthropic이 일반 공개한 모델 중 가장 뛰어난 모델: Fable 5의 후속, 100만 토큰 컨텍스트

## 가격 비교
- [Seedance API 가격 비교: 2.5·2.0·Fast](https://kovapi.com/ko/compare/seedance): 공식 정가와 OpenRouter, fal, Kie, Replicate, APIMart, KovAPI 가격을 나란히 비교 (2026-10-03 확인)
- [Nano Banana 2·Pro API 가격 비교](https://kovapi.com/ko/compare/nano-banana): 공식 정가와 OpenRouter, fal, Kie, Replicate, APIMart, KovAPI 가격을 나란히 비교 (2026-10-03 확인)
- [GPT Image 2·2.5 API 가격 비교](https://kovapi.com/ko/compare/gpt-image): 공식 정가와 OpenRouter, fal, Kie, Replicate, APIMart, KovAPI 가격을 나란히 비교 (2026-10-03 확인)
- [MiniMax H3(Hailuo 3) API 가격 비교](https://kovapi.com/ko/compare/minimax-h3): 공식 정가와 OpenRouter, fal, Kie, Replicate, APIMart, KovAPI 가격을 나란히 비교 (2026-10-03 확인)
- [Veo 3.1·Gemini Omni Flash API 가격 비교](https://kovapi.com/ko/compare/veo): 공식 정가와 OpenRouter, fal, Kie, Replicate, APIMart, KovAPI 가격을 나란히 비교 (2026-10-03 확인)
- [Wan 3.0·Wan 3.0 Prime API 가격 비교](https://kovapi.com/ko/compare/wan): 공식 정가와 OpenRouter, fal, Kie, Replicate, APIMart, KovAPI 가격을 나란히 비교 (2026-10-03 확인)

## 가이드
- [Seedance 2.5 특가 상품 사용 가이드](https://kovapi.com/ko/learn/seedance-special-tier-guide): Seedance 2.5 특가 상품으로 30초·720P 영상 만들기. 실제 샘플, 현재 가격, 긴 프롬프트 성공 사례, 혼잡 시간 참고와 120분 과금 보호를 안내합니다.
- [Seedance 2.5 API: 가격, 파라미터, 코드](https://kovapi.com/ko/learn/seedance-2-5-api): Seedance 2.5 영상 API: 720P 초당 $0.158, 4~30초, 참조 이미지 30장·영상 10개·오디오 10개. 바로 쓰는 curl·Python·Node.js 코드.
- [Seedance 30초 영상 API: 가격, 샘플, 코드](https://kovapi.com/ko/learn/seedance-30-second-video): Seedance 2.5는 30초를 한 번에 생성합니다. KovAPI에서는 seedance-2.5-30s(720P 건당 $2.00) 또는 초당 과금인 seedance-2.5를 씁니다. 샘플·프롬프트·코드 포함.

## 문서 및 기계 판독용 파일
- [문서 홈](https://docs.kovapi.com/ko/): 문서 홈: API 레퍼런스, 사용자 가이드, 연동
- [API 레퍼런스](https://docs.kovapi.com/ko/api/md): 전체 엔드포인트, 인증, 비동기 작업, 오류 형식, 요청 제한(Markdown)
- [API 문서 및 연동 가이드](https://docs.kovapi.com/ko/guide.md): 사용자 가이드 전문(Markdown)
- [오류 코드](https://docs.kovapi.com/ko/guide/errors/md): 모든 오류에 공통으로 쓰이는 형식, 코드별 의미, 그리고 오류를 받았을 때의 조치 방법.
- [비동기 작업](https://docs.kovapi.com/ko/guide/async-jobs/md): 이미지·영상 작업의 제출, 조회 또는 푸시 수신, 결과 다운로드 방법과 모든 상태·필드의 의미, 그리고 환불 방식.
- [과금과 환불](https://docs.kovapi.com/ko/guide/billing/md): 채팅·이미지·영상의 과금 방식, 크레딧 예약과 정산, 과금되지 않는 경우, 그리고 사용액 확인·충전·환불 방법.
- [요청 제한과 재시도](https://docs.kovapi.com/ko/guide/rate-limits/md): 계정과 키별 제한, 가득 찼을 때의 응답, 그리고 올바른 재시도와 시간 초과 설정 방법.
- [인증과 API 키](https://docs.kovapi.com/ko/guide/api-keys/md): API 키를 만들고, 쓰고, 제한하고, 교체하고, 안전하게 지키는 방법.
- [연동](https://docs.kovapi.com/ko/integrations): Claude Code, Cline, Cherry Studio 등 도구별 설정 방법
- [문서 MCP 서버](https://kovapi.com/mcp): 읽기 전용 MCP 엔드포인트(Streamable HTTP, 키 불필요): search_docs, read_doc, list_models
- [가격 JSON: 기계 판독용 판매 가격 (New API 호환)](https://kovapi.com/api/pricing)
- [Claude Code / Codex용 Agent Skill: npx skills add https://kovapi.com](https://docs.kovapi.com/ko/integrations/agent-skills)
- [클라이언트 설정 가이드 (SillyTavern, Cherry Studio, Cline)](https://docs.kovapi.com/ko/guides)

## 가격표

| 모델 ID | 이름 | 유형 | KovAPI 가격 | 공식가 (입력 / 출력) | 개발사 |
| --- | --- | --- | --- | --- | --- |
| gpt-5.6-sol | GPT-5.6 Sol | 채팅 / 추론 | $1.20 / $6.00 | $4.00 / $20.00 | OpenAI |
| gpt-5.6-luna | GPT-5.6 Luna | 채팅 / 추론 | $0.07 / $0.40 | $0.20 / $1.20 | OpenAI |
| gpt-6-astra | GPT-6 Astra | 채팅 / 추론 | $3.00 / $15.00 | $10.00 / $50.00 | OpenAI |
| gpt-6.1-sol | GPT-6.1 Sol | 채팅 / 추론 | $0.60 / $3.00 | $2.00 / $10.00 | OpenAI |
| gpt-6-sol | GPT-6 Sol | 채팅 / 추론 | $0.60 / $3.00 | $2.00 / $10.00 | OpenAI |
| gpt-6-luna | GPT-6 Luna | 채팅 / 추론 | $0.07 / $0.40 | $0.10 / $0.50 | OpenAI |
| gpt-image-2 | GPT Image 2 | 이미지 생성 | $0.005 / $0.025 / $0.04 (장당) | - | OpenAI |
| gpt-image-2.5-flare | GPT Image 2.5 Flare | 이미지 생성 | $0.005 / $0.03 / $0.05 (장당) | - | OpenAI |
| gpt-image-2.5-sunburst | GPT Image 2.5 Sunburst | 이미지 생성 | $0.005 / $0.03 / $0.05 (장당) | - | OpenAI |
| nano-banana-2 | Nano Banana 2 | 이미지 생성 | $0.015 / $0.025 / $0.04 (장당) | - | Google |
| nano-banana-pro | Nano Banana Pro | 이미지 생성 | $0.02 / $0.03 / $0.05 (장당) | - | Google |
| nano-banana-2.1 | Nano Banana 2.1 | 이미지 생성 | $0.015 / $0.025 / $0.04 (장당) | - | Google |
| grok-imagine-image | Grok Imagine Image | 이미지 생성 | $0.005 / $0.005 (장당) | - | xAI |
| grok-imagine-image-quality | Grok Imagine Image Quality | 이미지 생성 | $0.01 / $0.01 (장당) | - | xAI |
| claude-sonnet-4-6 | Claude Sonnet 4.6 | 채팅 / 추론 | $1.50 / $7.50 | $3.00 / $15.00 | Anthropic |
| claude-opus-5 | Claude Opus 5 | 채팅 / 추론 | $4.00 / $20.00 | $5.00 / $25.00 | Anthropic |
| claude-fable-5 | Claude Fable 5 | 채팅 / 추론 | $8.00 / $40.00 | $10.00 / $50.00 | Anthropic |
| claude-opus-5-5 | Claude Opus 5.5 | 채팅 / 추론 | $2.50 / $12.50 | $4.00 / $20.00 | Anthropic |
| claude-sonnet-5-5 | Claude Sonnet 5.5 | 채팅 / 추론 | $1.50 / $7.50 | $2.00 / $10.00 | Anthropic |
| gemini-4-argon | Gemini 4 Argon | 채팅 / 추론 | $0.50 / $3.00 | $2.00 / $10.00 | Google |
| gemini-3.1-pro | Gemini 3.1 Pro | 채팅 / 추론 | $0.50 / $3.00 | $2.00 / $12.00 | Google |
| gemini-3.8-flash | Gemini 3.8 Flash | 채팅 / 추론 | $0.60 / $3.60 | $0.75 / $3.75 | Google |
| deepseek-v4.1-flash | DeepSeek V4.1 Flash | 채팅 / 추론 | $0.075 / $0.30 | $0.15 / $0.60 | DeepSeek |
| deepseek-v4-flash-0731 | DeepSeek V4 Flash 0731 | 채팅 / 추론 | $0.13 / $0.51 | $0.15 / $0.60 | DeepSeek |
| glm-5.3 | GLM-5.3 | 채팅 / 추론 | $1.12 / $3.52 | $1.40 / $4.40 | Z.ai |
| qwen3.8-max | Qwen3.8 Max | 채팅 / 추론 | $1.40 / $4.20 | $2.00 / $6.00 | Alibaba |
| qwen3.8-flash | Qwen3.8 Flash | 채팅 / 추론 | $0.10 / $0.33 | $0.15 / $0.47 | Alibaba |
| grok-4.7 | Grok 4.7 | 채팅 / 추론 | $0.30 / $0.90 | $2.00 / $6.00 | xAI |
| veo-3.1 | Veo 3.1 | 영상 생성 | 720p $0.20 (건당), 1080p $0.22 (건당) | - | Google |
| gemini-omni-flash | Gemini Omni Flash | 영상 생성 | 720P $0.05/초, 1080P $0.05/초 | - | Google |
| seedance-2.5-token | Seedance 2.5 · Token | 영상 생성 | - | - | ByteDance |
| seedance-2.5-token-draft | Seedance 2.5 · Token Draft | 영상 생성 | - | - | ByteDance |
| seedance-2.5 | Seedance 2.5 | 영상 생성 | 480P $0.10/초, 720P $0.158/초, 1080P $0.33/초 | - | ByteDance |
| seedance-2.0 | Seedance 2.0 | 영상 생성 | 720P $0.15/초, 1080P $0.30/초 | - | ByteDance |
| seedance-2.0-fast | Seedance 2.0 Fast | 영상 생성 | 480P $0.046/초, 720P $0.075/초 | - | ByteDance |
| seedance-2.0-mini | Seedance 2.0 Mini | 영상 생성 | 480P $0.022/초, 720P $0.046/초 | - | ByteDance |
| seedance-2.0-clip | Seedance 2.0 · Clip | 영상 생성 | 720P $1.00 (건당) | - | ByteDance |
| seedance-2.5-30s | Seedance 2.5 · Special | 영상 생성 | 720P $2.00 (건당) | - | ByteDance |
| wan3.0-video | Wan 3.0 | 영상 생성 | 480P $0.04/초, 720P $0.065/초, 1080P $0.13/초 | - | Alibaba |
| wan3.0-video-prime | Wan 3.0 Prime | 영상 생성 | - | - | Alibaba |
| minimax-h3 | MiniMax H3 | 영상 생성 | 1080P $0.036/초 | - | MiniMax |
| grok-imagine-video-1.5 | Grok Imagine Video 1.5 | 영상 생성 | 480P $0.30 (건당), 720P $0.40 (건당) | - | xAI |

## 코드 예제

### 채팅 (OpenAI SDK)

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://kovapi.com/v1",
    api_key="YOUR_KOVAPI_API_KEY",
)

stream = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": "Explain rate limiting in two sentences."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
```

### curl

```bash
curl https://kovapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KOVAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [{"role": "user", "content": "Explain rate limiting in two sentences."}],
    "stream": true
  }'
```

### 이미지 (비동기 작업)

```bash
# 1) submit: returns HTTP 202 and a job id
curl https://kovapi.com/v1/images/generations \
  -H "Authorization: Bearer $KOVAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2", "prompt": "A red fox in fresh snow, soft morning light", "size": "16:9", "resolution": "1K"}'

# 2) poll every 3 s until "status" is "succeeded", then read data[0].url
curl https://kovapi.com/v1/images/jobs/JOB_ID \
  -H "Authorization: Bearer $KOVAPI_API_KEY"
```

### 영상 (비동기 작업)

```python
import time
import requests

BASE = "https://kovapi.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_KOVAPI_API_KEY"}

job = requests.post(f"{BASE}/videos/generations", headers=HEADERS, json={
    "model": "seedance-2.5",
    "prompt": "A paper boat drifting down a rainy street at night, neon reflections",
    "seconds": 5,
    "resolution": "720P",
    "size": "16:9",
}).json()

while True:
    r = requests.get(f"{BASE}/videos/jobs/{job['id']}", headers=HEADERS).json()
    if r["status"] == "succeeded":
        print(r["data"][0]["url"])
        break
    if r["status"] == "failed":
        raise RuntimeError(r["error"]["message"])
    time.sleep(15)
```

## Seedance 콘텐츠 요건

Seedance의 모든 작업은 콘텐츠 심사를 거칩니다. 대상은 프롬프트, 참조 소재, 생성된 영상이며 화면과 소리를 모두 심사합니다. 심사를 통과하지 못한 작업은 `content_policy`로 실패하며 과금되지 않습니다.

### 심사 시점

제출할 때 프롬프트와 참조 소재를 먼저 심사하고, 영상이 생성된 뒤 화면과 소리를 다시 심사합니다. 그래서 거절 결과는 제출 후 몇 초 만에 올 수도 있고 렌더링이 끝난 뒤에야 올 수도 있습니다(30분 넘게 걸릴 수도 있습니다). `status`가 `failed`, `error.code`가 `content_policy`로 끝난 작업은 심사에서 거절된 것입니다. Webhook을 쓰면 `video.failed` 이벤트가 전달됩니다.

### 과금 없음

거절된 작업은 과금되지 않습니다. 제출할 때 보류한 금액은 작업이 끝날 때 전액 환불되며, 호출 로그에도 과금되지 않은 것으로 표시됩니다.

### 소리

소리(대사, 내레이션, 노래, 효과음)는 모델이 프롬프트에 따라 생성하며 화면과 함께 심사합니다. 프롬프트에 쓴 대사, 내레이션, 가사는 실제로 읽히거나 노래로 불립니다. 목소리가 필요 없는 영상이라면 프롬프트에 대사와 가사를 쓰지 마세요. Seedance 영상에는 항상 소리가 포함되며 끌 수 없습니다. 업로드한 참조 오디오도 심사하며, 저작권이 있는 음악을 참조 오디오로 쓰면 거절될 수 있습니다. 소리가 심사를 통과하지 못하면 `error.param`이 `audio`가 되고, message에 생성된 소리인지 업로드한 참조 오디오인지 적혀 있습니다.

### 자주 거절되는 내용

- 성적 내용, 노출, 성적 암시(AI로 생성하거나 합성한 이미지 포함)
- 유혈, 잔혹한 묘사, 자해, 총상과 출혈 같은 폭력적 부상
- 총기, 폭발물, 마약
- 미성년자를 성적으로 다루는 내용은 일절 불가하며, 미성년자와 술·담배·마약·위험한 행동이 함께 나오는 장면도 거절됩니다
- 정치인, 연예인, 운동선수, 기업인 등 공인의 외모나 목소리(닮은 인물 포함)
- 저작권이 있는 캐릭터와 IP(디즈니, 마블 캐릭터 등)
- 혐오·차별 콘텐츠와 가짜 뉴스

### 긴 스토리보드 대본

위반 장면이 하나라도 있으면 영상 전체가 거절되며, 긴 스토리보드 대본에서 특히 자주 일어납니다. 액션 장면의 총격전이나 출혈 클로즈업, 미성년자가 술을 마시거나 담배를 피우는 장면이 있으면 전체가 실패합니다. 제출 전에 대본을 끝까지 읽고 이런 장면을 삭제하거나 고쳐 쓰세요.

### 실존 인물

실존 인물의 사진을 참조로 쓰려면 그 사람의 초상을 사용할 권리가 있어야 합니다.

### 거절된 뒤

같은 내용으로 다시 제출해도 다시 거절됩니다. 문제가 될 만한 부분을 찾아 프롬프트를 고쳐 쓰거나 참조 소재를 바꾼 뒤 다시 제출하세요.

오류 코드: `content_policy` · `status: failed`

`upstream_line_unavailable`: 생성 서비스가 과부하 상태이거나 가용 리소스가 소진되면 upstream_line_unavailable을 반환합니다. 실패 작업은 과금되지 않으며 예약 크레딧은 반환됩니다. 잠시 후 다시 시도해 주세요. 이 오류는 특정 매개변수나 자료의 문제를 지적하지 않습니다. 명확한 길이 제한, 참조 읽기 실패, 심사 거절은 각각 duration_rejected, reference_unreadable, content_policy를 유지하므로 해당 안내를 따라 주세요.

## 자주 묻는 질문

### KovAPI는 무엇인가요?

KovAPI는 OpenAI 호환 AI API 플랫폼입니다. 키 하나로 채팅, 이미지, 영상 모델을 모두 쓸 수 있습니다. 기존 OpenAI SDK 코드는 기본 URL을 https://kovapi.com/v1로 바꾸고 KovAPI 키를 넣기만 하면 연결되며, Claude 모델은 Anthropic 네이티브 API도 지원합니다.

### NezhaGate와 KovAPI는 어떤 관계인가요?

KovAPI는 NezhaGate의 새 이름이며, 이제 kovapi.com에서 서비스합니다. 계정, 잔액, API 키, 가격은 그대로이고 nezhagate.com API 주소도 계속 사용할 수 있어 기존 코드를 바꿀 필요가 없습니다. 웹사이트는 kovapi.com에서 한 번 다시 로그인해 주세요.

### "채팅, 이미지, 영상 — 하나의 API"는 구체적으로 무슨 뜻인가요?

Base URL 하나와 API 키 하나로 세 가지 일을 모두 처리한다는 뜻입니다. 채팅은 /v1/chat/completions, 이미지는 /v1/images/generations(이미지-투-이미지는 /v1/images/edits), 영상은 /v1/videos/generations를 씁니다. 모델은 OpenAI(GPT), Anthropic(Claude), Google(Gemini), 바이트댄스(Seedance), 알리바바(Wan), xAI(Grok), MiniMax 등 여러 벤더의 것이며, 벤더마다 SDK를 연동하고 계정을 만들고 정산을 따로 할 필요가 없습니다. 모델을 바꾸거나 비교할 때는 model 파라미터 하나만 바꾸면 됩니다.

### KovAPI는 공식 OpenAI / Claude / Gemini API와 무엇이 다른가요?

KovAPI가 제공하는 것은 각 벤더의 원본 모델이고, 달라지는 것은 이용 방식입니다. 키 하나로 모든 벤더의 모델을 호출하고, API는 모두 OpenAI와 호환되며(Claude는 Anthropic 네이티브 API도 지원), 과금·로그·잔액은 콘솔 하나에서 관리됩니다. 주력 모델은 여러 공급사에 연결되어 장애 시 자동으로 전환되고, 공식가 대비 최대 85%를 절약할 수 있습니다.

### 어떤 모델을 지원하나요?

KovAPI는 현재 OpenAI의 GPT-6 패밀리(Astra / 6.1 Sol / Sol / Luna), GPT-5.6 패밀리(Sol / Luna)와 이미지 모델 GPT Image 2, GPT Image 2.5(Flare / Sunburst), Anthropic의 Claude Opus 5.5, Claude Sonnet 5.5, Claude Opus 5, Claude Sonnet 4.6, Claude Fable 5, Google의 Gemini 3.1 Pro, Gemini 3.8 Flash와 이미지 모델 Nano Banana 2.1, Nano Banana 2, Nano Banana Pro, DeepSeek V4.1 Flash와 V4 Flash 0731, Z.ai의 GLM-5.3, Alibaba의 Qwen3.8 패밀리(Max / Flash), xAI의 Grok 4.7과 이미지 모델 Grok Imagine Image(표준 / 고품질), 그리고 영상 모델로 Seedance 2.5와 Seedance 2.0 패밀리, Wan 3.0, MiniMax H3, Grok Imagine Video 1.5를 제공합니다. 모든 모델은 같은 엔드포인트와 키로 호출하며, 실시간 전체 목록은 모델 마켓에서 확인할 수 있습니다.

### KovAPI의 모델은 각 벤더의 오리지널 모델인가요?

네. 요청한 모델이 그대로 답변하며, 출력을 고쳐 쓰지도 않습니다. 유일한 예외는 중국 모델인 GLM, Qwen입니다. 해당 모델이 잠시 답변할 수 없으면 같은 수준 이상의 모델이 대신 답변하고, 요금은 두 모델 중 더 낮은 가격으로 청구되며, 호출 로그에 어떤 모델이 답변했고 어떤 가격이 적용됐는지 표시됩니다. 모든 호출은 로그에서 모델, 사용량, 과금액, 소요 시간을 확인할 수 있고, 모델별 실시간 상태는 상태 페이지에 공개됩니다. 또한 매주 고정된 질문 세트로 주력 모델을 테스트해 성공률, 첫 토큰까지의 시간, 출력 속도를 측정합니다.

### GPT, Claude, Gemini를 모두 지원하나요?

지원합니다. GPT(OpenAI), Claude(Anthropic), Gemini(Google)의 주요 모델을 하나의 OpenAI 호환 인터페이스로 모두 쓸 수 있습니다. 모델을 바꿀 때는 요청의 model 필드만 바꾸면 되고 새 SDK나 재연동이 필요 없습니다.

### 이미지와 영상 생성을 지원하나요?

네. 이미지는 GPT Image 2, GPT Image 2.5(Flare / Sunburst), Nano Banana 2.1, Nano Banana 2, Nano Banana Pro를 지원하며, 텍스트→이미지는 /v1/images/generations, 이미지→이미지는 /v1/images/edits로 최대 4K까지 생성합니다. 영상은 Seedance, Wan 3.0, MiniMax H3, Grok Imagine Video를 /v1/videos/generations로 호출합니다. 결과는 바로 쓸 수 있는 직접 링크로 반환됩니다.

### 가격과 모델 정보는 얼마나 자주 업데이트되나요?

요금 페이지와 모델 마켓은 과금 시스템과 실시간으로 연동되어, 화면에 보이는 가격이 곧 실제 과금 가격입니다. 새 모델과 가격 변경은 적용되는 즉시 페이지에 반영되며, 가격 변경은 하루 전에 사이트에서 공지합니다.

### KovAPI의 가격은 어떻게 정해지나요? 숨은 비용이 있나요?

KovAPI는 실제 사용량으로 과금합니다. 채팅은 토큰 단위, 이미지는 장 단위, 영상은 대부분 초 단위입니다(일부 모델은 건당 과금하며 요금 페이지에 표시됩니다). 공식가 대비 최대 85%를 절약할 수 있고, 모든 모델의 가격은 요금 페이지에 공식가와 나란히 공개됩니다. 숨은 배율도, 충전 후에야 보이는 가격도 없습니다. 가격 변경은 하루 전에 사이트에서 공지합니다.

### KovAPI는 왜 공식보다 저렴한가요?

KovAPI는 여러 공급사로부터 모델 사용량을 소매가보다 낮은 가격에 대량으로 구매하기 때문에, 대부분의 모델이 공식 API보다 저렴합니다. 모델별로 얼마나 절약되는지는 요금 페이지에서 하나하나 확인할 수 있습니다. 수익은 구매가와 판매가의 차액에서 나오며, 충전 수수료는 받지 않습니다.

### 실패한 호출은 어떻게 과금되나요?

KovAPI는 실패한 호출에 요금을 부과하지 않습니다. 이미지·영상 같은 비동기 작업은 제출할 때 크레딧을 미리 예약하고, 작업이 실패하면 자동으로 전액 환불하며 실패 사유를 로그에 남깁니다. 스트리밍 답변이 중간에 끊기면 업스트림이 실제로 반환한 사용량만큼만 과금됩니다.

### KovAPI 크레딧은 만료되나요? 환불할 수 있나요?

KovAPI 크레딧은 만료되지 않습니다. 충전은 WeChat Pay는 ¥10(260 크레딧)부터, USDT와 카드는 $5부터 가능하며, 새 계정에는 가입 즉시 30 크레딧을, 첫 충전 시 50 크레딧을 추가로 무료로 드립니다. 충전 내역과 최근 60일간 모든 호출의 과금 내역은 콘솔에서 확인할 수 있습니다. 충전 후 7일 이내라면 사용하지 않은 구매 크레딧을 고객지원을 통해 환불받을 수 있으며, 환불 1건당 수수료(2026년 10월 29일 이후 충전은 $1.40, 그 이전 충전은 $0.40)가 차감됩니다. 보너스 크레딧은 환불되지 않으며, USDT 결제도 환불할 수 있습니다.

### 잔액과 사용량은 어떻게 확인하나요?

로그인하면 콘솔에서 실시간 잔액, API 키별 사용량, 최근 60일간의 모든 호출(모델, 시간, 토큰 수 또는 이미지 수, 응답 시간, 과금액)을 확인할 수 있고, 실패한 호출에는 사유가 표시됩니다. 잔액 조회 엔드포인트로 프로그램에서 잔액을 읽을 수도 있습니다.

### KovAPI는 안정적인가요?

KovAPI는 GPT, Gemini, DeepSeek, GLM, Kimi, GPT Image, Nano Banana, Seedance 2.0 등 주력 모델을 여러 공급사에 연결해 두었습니다. 한 곳에서 오류가 나거나 시간이 초과되거나 용량이 가득 차면, 요청은 같은 모델의 다음 공급사로 자동 전환됩니다. 스트리밍 답변은 출력이 시작되기 전에 전환되며, 출력이 시작된 뒤에는 옮겨지지 않습니다. 게이트웨이는 24시간 2분마다 자동으로 점검하며, 모델별 운영 상태와 게이트웨이 가용성은 상태 페이지에 실시간으로 공개되고, 성공률은 실제 고객 트래픽만으로 계산합니다. 실패한 호출에는 과금하지 않으며, 실패한 이미지·영상 작업은 전액 환불됩니다.

### KovAPI에 호출 빈도 제한이 있나요?

KovAPI는 계정별 기본 빈도 제한을 두지 않습니다. API 키 페이지에서 키마다 분당 요청 수 상한, 일일 예산, 총 사용 한도, 모델 허용 목록, IP 허용 목록을 직접 설정할 수 있습니다. 어떤 모델이 가득 차면 Retry-After 헤더와 함께 429가 반환되니, 그 시간이 지난 뒤 다시 시도하세요. 지속적으로 높은 동시 처리량이 필요하면 미리 고객지원에 연락해 주세요. 사용량에 맞춰 용량을 늘려 드립니다. 무료 프로모션 모델에는 일일 호출 횟수 제한이 있습니다.

### 상용 프로젝트나 AI 툴 사이트에 적합한가요?

네. KovAPI는 OpenAI 호환 API, 프로젝트별로 나눌 수 있는 API 키(키마다 사용 한도·빈도·모델·IP 제한 설정 가능), 건별로 확인 가능한 호출 로그, 실패 시 과금하지 않는 정산 방식을 갖추고 있어 상용 제품과 툴 사이트에 바로 연동할 수 있습니다. 이용 시 서비스 약관과 각 모델 벤더의 이용 정책을 지켜 주세요.

### 기업 협업이나 대량 호출도 가능한가요?

가능합니다. KovAPI는 더 큰 규모의 배치 호출을 처리할 수 있으며 기업 문의를 환영합니다. 더 높은 동시성, 전용 할당량, 연동 관련 요구가 있으시면 support@kovapi.com 으로 메일을 보내시거나 사이트의 문의하기로 연락해 주세요. 사용량과 상황에 맞춰 안을 제안해 드립니다.

### KovAPI는 어떤 상황에 가장 잘 맞나요?

한 프로젝트에서 여러 모델 공급사를 호출해야 하거나, 과금과 사용량을 한곳에서 관리하고 싶거나, 여러 모델을 빠르게 검증하고 싶을 때 잘 맞습니다. AI 도구 사이트, SaaS 제품, 자동화 워크플로, 에이전트, 다중 모델 비교에 많이 쓰입니다. 모델 사이를 유연하게 오가야 할 때 특히 편합니다.

### KovAPI를 빠르게 시작하려면 어떻게 하나요?

세 단계면 됩니다. 계정을 만들고, 콘솔에서 API 키를 발급하고, Base URL을 KovAPI로 돌린 뒤 키를 넣으면 됩니다. OpenAI와 완전히 호환되므로 기존 OpenAI SDK 코드는 거의 고칠 필요가 없고 base_url과 api_key만 바꾸면 됩니다. 자세한 내용은 개발자 문서를 참고하세요.

### Base URL은 어떻게 설정하나요?

Base URL을 https://kovapi.com/v1 로 설정하세요. OpenAI SDK에서는 base_url(또는 OPENAI_BASE_URL 환경 변수)을 이 주소로 두고 콘솔에서 만든 키를 쓰면 됩니다. 채팅은 /v1/chat/completions, 이미지는 /v1/images/generations를 쓰며 경로는 OpenAI와 같습니다.

### OpenAI SDK와 호환되나요?

호환됩니다. KovAPI는 OpenAI 호환 인터페이스를 구현하므로 공식 openai SDK에서 base_url과 api_key만 바꾸면 동작합니다. 요청과 응답 형태가 OpenAI와 같고 스트리밍 출력과 멀티모달 입력도 지원합니다.

### Python, Node.js, curl을 지원하나요?

지원합니다. HTTP 요청을 보낼 수 있거나 OpenAI SDK를 쓸 수 있는 언어라면 무엇이든 되며 Python, Node.js, Go, Java, 순수 curl 모두 포함됩니다. 문서에 바로 실행할 수 있는 Python, Node.js, curl 예제가 있습니다.

### n8n, Dify, LangChain, Open WebUI, LobeChat, Cherry Studio, ChatBox를 지원하나요?

지원합니다. 이들 도구는 대부분 OpenAI 호환 Base URL과 API 키를 직접 지정할 수 있으므로, KovAPI로 돌리면 플랫폼의 모델을 그대로 쓸 수 있습니다. OpenAI 호환이나 사용자 지정 엔드포인트를 지원하는 도구라면 별도 플러그인 없이 연결됩니다.

### API 키가 유출되면 어떻게 하나요?

API 키가 유출된 것 같으면 콘솔에서 즉시 삭제하거나 교체하세요. 폐기한 키는 더 이상 사용할 수 없습니다. 프로젝트마다 키를 따로 만들고 프런트엔드 코드나 공개 저장소에 키를 넣지 않기를 권합니다. 콘솔에서 키별 사용량을 언제든 확인해 이상 징후를 잡을 수 있습니다.

### KovAPI는 제 데이터를 저장하거나 들여다보나요?

KovAPI는 호출 내용을 해당 호출을 처리하고, 로그에서 보여 드리고, 장애를 조사하는 데에만 사용합니다. 어떤 모델의 학습에도 쓰지 않으며, 판매하거나 광고주에게 제공하지도 않습니다. 호출 처리에 꼭 필요한 모델 공급사와 인프라 서비스(CDN, 클라우드 스토리지, 웹 검색을 켰을 때의 검색 서비스)를 제외하고는 제3자에게 제공하지 않습니다. 호출 로그는 콘솔에 60일간 보관되며, 그중 텍스트 내용은 30일 후 삭제되고 과금에 필요한 사용 기록만 남습니다. 생성한 이미지와 영상은 15일 후, 업로드한 참조 파일은 7일 후 삭제됩니다. 데이터베이스 백업은 최대 30일간 추가로 보관됩니다.

### 계정과 API 키는 안전한가요?

API 키마다 사용 한도, 분당 요청 수 상한, 모델 허용 목록, IP 허용 목록을 따로 설정할 수 있고 언제든 비활성화하거나 삭제할 수 있어, 키 하나가 유출돼도 다른 프로젝트에는 영향이 없습니다. 키는 서버에 암호화해 저장되며, 로그인한 상태에서는 언제든 확인하고 복사할 수 있습니다. 모든 호출과 잔액 변동은 건별로 확인할 수 있습니다.

### 문제가 생기면 어디에 문의하나요?

KovAPI 고객지원은 사이트 상단 내비게이션과 콘솔의 「문의」에 있습니다. WeChat, Telegram 그룹, 이메일(support@kovapi.com)로 문의할 수 있습니다. 지원 시간은 베이징 시간 10:00–19:00(UTC+8)이며, 메시지를 확인한 뒤 1시간 이내에 답변합니다.

### 금지되는 사용에는 어떤 것이 있나요?

법령이나 각 모델 벤더의 이용 정책을 위반하는 용도로는 KovAPI를 쓸 수 없습니다. 불법 · 침해 · 사기 · 악성코드 콘텐츠를 만들거나 퍼뜨리는 행위, 자동화된 남용, 할당량이나 안전 장치를 우회하는 행위가 여기에 포함됩니다. 위반하면 계정이 제한되거나 해지될 수 있습니다. 전체 규정은 서비스 약관에 있습니다.

### KovAPI를 사용할 때 주의할 점은 무엇인가요?

API 키를 안전하게 보관하고 필요한 만큼 충전하며, 서비스 약관과 각 모델 벤더의 이용 정책을 지켜 주세요. 호출 전에 요금 페이지에서 단가를 확인하고, 키에 일일 예산과 총 사용 한도를 설정해 두면 예상치 못한 지출을 막을 수 있습니다.

## Optional
- https://kovapi.com/ko/llms.txt
- https://kovapi.com/ko/pricing
- https://docs.kovapi.com/ko/guide
- https://kovapi.com/ko/faq