한국 리전 Closed Beta 안내
한국 리전은 현재 Closed Beta로 운영되어, 이용을 위해서는 별도 권한 부여가 필요합니다. 도입을 원하시면 Contact Us로 문의해주세요. 비즈니스 담당자가 확인 후 안내해 드리며, 문의 내용에 '한국 리전 Closed Beta'를 기재해 주시면 더 빠르게 도와드릴 수 있습니다.
업스테이지는 데이터 처리 요건에 맞게 지역(Region)별로 분리된 API 환경을 제공해요. 현재 한국 리전이 제공되며, 이 문서에서 한국 리전의 접속 경로와 사용 방법, 그리고 SLA 정보를 안내해요.
한국 리전
데이터가 한국 내에서 처리되어야 하는 경우(데이터 레지던시 요구사항이 있는 경우) 한국 리전 전용 엔드포인트 kr.api.upstage.ai 를 사용해주세요. API 요청과 처리되는 데이터 모두 한국 리전 내에서만 다뤄져요.
지원 모델은 Solar Mini 4, Solar Decide, Document Parse, OCR, Information Extract 예요.
한국 리전 Enhanced 모드 미지원
한국 리전의 Document Parse와 Information Extract는 standard 모드만 지원해요. mode: "enhanced"는 사용할 수 없어요. 또한 글로벌 리전과 모델 성능이 다를 수 있으니, 운영 적용 전 실제 문서로 테스트해 보시는 것을 권장해요.
사용 방법
기존 글로벌 엔드포인트에서 도메인만 한국 리전 도메인으로 바꿔서 호출하면 돼요.
Solar Mini 4, Solar Decide, Document Parse, OCR은 글로벌 리전과 동일한 모델 이름을 그대로 사용해요. 한국 리전에서 Solar Mini 4와 Solar Decide는 아래 API로 호출해요.
| 모델 | 모델 이름 | API |
|---|---|---|
| Solar Mini 4 | solar-mini4, solar-mini4-260922 | Chat Completions (POST /v1/chat/completions) |
| Solar Decide | solar-decide, solar-decide-flash | System One (POST /v1/systemone) |
Information Extract만 한국 리전 전용 모델 이름을 지정해주세요.
| 모델 | 글로벌 | 한국 리전 |
|---|---|---|
| Information Extract | information-extract | information-extract-kr-261113 |
information-extract-kr-260904는 2026년 12월 14일(KST)에 서비스가 종료돼요. 이후 이 버전을 지정한 요청은 오류를 반환해요. information-extract-kr-261113으로 마이그레이션해 주세요.
한국 리전 파일 입력은 base64만 지원
한국 리전의 Information Extract에는 입력 파일을 base64로 인코딩한 문자열로 전달해주세요. 파일 URL은 지원하지 않으며, URL로 전달하면 file_download_failed(400) 오류가 발생해요.
SLA
한국 리전의 Rate limit은 모델별로 아래와 같이 적용돼요.
Solar Mini 4 · Solar Decide
한국 리전의 Solar Mini 4는 글로벌 리전과 동일한 Tier별 Rate limit이 적용돼요. Solar Decide는 Solar Mini 4와 동일한 Rate limit을 사용해요.
| Tier | RPM (Requests per minute) | TPM (Tokens per minute) |
|---|---|---|
| Tier 0 | 100 | 50,000 |
| Tier 1 (Explore) | 400 | 150,000 |
| Tier 2 (Build) | 2,000 | 750,000 |
| Tier 3 (Scale) | 4,000 | 1,500,000 |
| Tier 4 (Enterprise) | 8,000 | 3,000,000 |
Document Parse
한국 리전의 Document Parse는 글로벌 리전과 동일한 Tier별 Rate limit이 적용돼요.
Synchronous API
| Tier | RPS (Requests per second) | PPM (Pages per minute) |
|---|---|---|
| Tier 0 | 3 | 500 |
| Tier 1 (Explore) | 6 | 1,000 |
| Tier 2 (Build) | 10 | 1,500 |
| Tier 3 (Scale) | 15 | 2,000 |
| Tier 4 (Enterprise) | 20 | 3,000 |
Asynchronous API
| Tier | RPS (Requests per second) | PPM (Pages per minute) |
|---|---|---|
| Tier 0 | 6 | 1,200 |
| Tier 1 (Explore) | 12 | 3,600 |
| Tier 2 (Build) | 20 | 12,000 |
| Tier 3 (Scale) | 30 | 18,000 |
| Tier 4 (Enterprise) | 40 | 24,000 |
OCR
한국 리전의 OCR은 글로벌 리전과 동일한 Tier별 Rate limit이 적용돼요.
Synchronous API
| Tier | RPS (Requests per second) | PPM (Pages per minute) |
|---|---|---|
| Tier 0 | 3 | 500 |
| Tier 1 (Explore) | 6 | 1,000 |
| Tier 2 (Build) | 10 | 1,500 |
| Tier 3 (Scale) | 15 | 2,000 |
| Tier 4 (Enterprise) | 20 | 3,000 |
Information Extract
한국 리전의 Information Extract는 현재 베타 단계로 제공됩니다. Synchronous API만 지원되며, 약정 등급(Commitment tier)과 무관하게 아래의 단일 Rate limit이 적용됩니다.
| API | 제공 상태 | PPM (Pages per minute) |
|---|---|---|
| Information Extract — Synchronous | Beta | 60 |
Tier는 사용 중인 약정에 따라 자동으로 배정돼요. 현재 Tier는 크레딧 페이지의 Rate limit 섹션에서 확인할 수 있어요. 더 자세한 Rate limit 정책은 Rate limits 가이드를 참고해주세요.