AI Initiative,
차근차근 시작합니다

시작하기 전에

이 Part는 개발 경험이 없으신 분을 기준으로 쓰였습니다. 용어가 낯설어도 괜찮습니다. 필요한 설명을 그때그때 함께 드리므로, 위에서부터 순서대로 읽어 내려오시면 됩니다.

0.1사용할 수 있는 모델

AI Initiative로 무상으로 쓰는 건 Solar Pro 2 · Solar Pro 3 · Solar Pro 4 · Document Parse 네 가지입니다. 이 안에서 고르시면 됩니다.

Pro 2 · Pro 3 · Pro 4 중 무엇을 고를까요

지금 시작하신다면 Solar Pro 4입니다. 세 모델 모두 이 프로그램에서 무상으로 쓰실 수 있고, 요청 주소와 호출 한도도 같습니다. 조건이 같다면 최신 세대를 고르시는 편이 낫습니다. 공식 문서와 쿡북 예제도 solar-pro4 기준으로 쓰여 있어 그대로 따라 하실 수 있고요.

세 모델은 요청 형식이 서로 같습니다. 옮기실 때는 model 값만 바꾸시고 나머지 설정은 그대로 두시면 됩니다.

0.2준비물 네 가지

계정 · 결제수단 · API 키 · 실습 환경, 네 가지를 갖추면 첫 호출을 하실 수 있습니다. 한 단계씩 함께 진행해 보겠습니다.

0.3호출 한도 이해하기

AI Initiative 계정은 Tier 0 등급으로 제공됩니다. 1분 동안 보낼 수 있는 요청 수와 처리할 수 있는 분량에 기준이 정해져 있습니다. 미리 알아 두시면 수업이나 대량 처리를 계획하실 때 도움이 됩니다.

Solar Pro 2 · Solar Pro 3 · Solar Pro 4에 같은 기준이 적용됩니다. 내 등급과 한도는 콘솔의 Billing → Commitment → Rate limit에 있습니다.

이런 상황에서 한도에 닿습니다

혼자서 하나씩 실행하실 때는 한도에 닿는 일이 드뭅니다. 다만 아래처럼 짧은 시간에 몰아서 요청하실 때는 미리 준비해 두시면 좋습니다.

429 응답을 받으셨다면

429는 고장이 아니라 "잠시 천천히 보내 주세요"라는 신호입니다. 아래 순서대로 하시면 됩니다.

1. 곧바로 다시 보내지 마시고, 몇 초 기다린 뒤 다시 보냅니다. 그래도 같다면 기다리는 시간을 조금씩 늘립니다.
2. 동시에 실행하는 개수를 줄입니다. 한 번에 10개씩 보내고 계셨다면 2~3개로 줄여 보세요.
3. 수업 중이시라면 조를 나누어 순서대로 진행합니다.

지금 얼마나 남았는지 확인하기

모든 응답에는 남은 사용량이 함께 담겨 옵니다. 아래 명령을 실행하면 응답 본문 대신 이 정보만 나옵니다.

curl -s -D - -o /dev/null \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "solar-pro4", "messages": [{"role": "user", "content": "안녕하세요"}]}' \
  https://api.upstage.ai/v1/chat/completions \
  | grep -i "X-Upstage-RateLimit"

0.4첫 응답 받아보기

준비가 끝났다면 실제로 실행해 보겠습니다. Solar와 Document Parse를 각각 한 번씩 성공시키는 것이 이 절의 목표입니다.

① Solar에게 말을 걸어봅니다

아래 코드를 터미널에 붙여 넣고 실행합니다. 터미널은 컴퓨터에 명령어를 직접 입력하는 창입니다. Windows에서는 PowerShell, macOS에서는 터미널 앱을 여시면 됩니다.

$UPSTAGE_API_KEY 자리에는 앞에서 발급받으신 키를 넣어 주세요.

curl -X POST https://api.upstage.ai/v1/chat/completions \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "solar-pro4",
    "messages": [
      {"role": "user", "content": "한 문장으로 자기소개를 해 주세요."}
    ]
  }'

잠시 뒤 중괄호로 시작하는 긴 응답이 돌아옵니다. 처음 보시면 복잡해 보이지만, 실제로 확인하실 부분은 많지 않습니다.

파이썬을 사용하신다면 준비가 더 간단합니다. Solar는 OpenAI API와 호환되므로, 이미 알려진 OpenAI 라이브러리를 그대로 쓰시고 주소만 Upstage로 바꾸시면 됩니다.

pip install --upgrade openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UPSTAGE_API_KEY"],
    base_url="https://api.upstage.ai/v1",
)

response = client.chat.completions.create(
    model="solar-pro4",
    messages=[{"role": "user", "content": "한 문장으로 자기소개를 해 주세요."}],
)

print(response.choices[0].message.content)

② 문서를 텍스트로 바꿔봅니다

이번에는 Document Parse입니다. PDF나 이미지를 컴퓨터가 읽을 수 있는 형태로 바꿔 줍니다. 주소가 앞의 Solar와 다르다는 점만 기억해 주세요.

가지고 계신 PDF 파일 하나를 sample.pdf라는 이름으로 같은 폴더에 두시고 실행합니다.

curl -X POST https://api.upstage.ai/v1/document-digitization \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -F "document=@sample.pdf" \
  -F "model=document-parse" \
  -F "ocr=force"

여기까지 오셨다면

• Solar 요청에서 모델이 만든 한국어 문장을 확인하셨습니다.
• Document Parse 요청에서 문서 내용이 담긴 응답을 확인하셨습니다.
• 두 요청 모두 오류 없이 마무리되었습니다.

세 가지가 모두 확인되었다면 Part 0의 실습은 끝났습니다. 수고하셨습니다.

0.5[활동] 준비 체크리스트

아래 템플릿을 복사해 직접 채워 보세요. 손으로 한 번 정리해 두면 다음 Part가 훨씬 수월합니다.

# AI Initiative 준비 체크리스트

## 1. 계정과 크레딧
- [ ] console.upstage.ai 로그인을 마쳤습니다
- 가입한 이메일:
- [ ] Billing → Credit 에서 잔액을 확인했습니다
- 현재 잔액:

## 2. 결제수단
- [ ] Billing 에 결제수단을 등록했습니다

## 3. API 키
- [ ] up_ 으로 시작하는 키를 발급받았습니다
- [ ] 키를 안전한 곳에 보관했습니다
  (Colab이라면 보안 비밀 이름: UPSTAGE_API_KEY / 노트북 액세스 켜기)

## 4. 첫 응답
- [ ] Solar 응답을 확인했습니다 — 사용한 모델:
- [ ] Document Parse 응답을 확인했습니다
- 오류가 있었다면 응답 번호:

## 5. 나의 사용 계획
- 소속 (대학 / 대학병원 / 비영리·비정부 기관):
- 자동화하고 싶은 업무:
- 예상 사용 규모 (한 번에 몇 건, 동시에 몇 명):
  → 0.3 의 한도 안에 들어오는지 확인

체크포인트

• 다섯 항목을 모두 채웠습니다.
• Solar와 Document Parse 응답을 각각 한 번 이상 눈으로 확인했습니다.
• 나의 사용 규모가 Tier 0 한도 안에 들어오는지 판단했습니다.
• 한도를 넘을 것 같다면 어떻게 나누어 보낼지 한 줄로 적었습니다.

0.6자주 묻는 질문

시작 단계에서 많이 주시는 질문을 모았습니다. 증상으로 찾아 들어가시면 됩니다.

다음 Part 안내

Part 0을 마치셨다면, 소속과 목적에 맞는 경로로 이어서 진행하시면 됩니다.