Ollama API 소개

Ollama API 소개 (Introduction)

Ollama로 로컬에서 모델을 내려받아 실행했다면, 이제 그 모델을 애플리케이션에서 어떻게 부를지 궁금할 거예요. Ollama는 설치만 하면 기본적으로 로컬에서 REST API를 제공해서, curl 이나 공식 라이브러리로 모델과 대화하거나 임베딩을 뽑을 수 있어요.

출처: Ollama 공식 문서 — API Introduction

시작하기

Ollama는 설치 후 별도 설정 없이도 API가 자동으로 켜져요. 기본 주소(base URL)는 로컬 실행 기준 이렇게 돼요.

http://localhost:11434/api

클라우드 모델을 ollama.com 에서 쓸 때는 같은 API를 다음 base URL로 사용해요.

https://ollama.com/api

예제 요청

Ollama가 실행 중이면 바로 curl 로 요청을 보낼 수 있어요. /api/generate 와 /api/chat 이 대표적인 엔드포인트예요.

curl http://localhost:11434/api/generate -d '{
  "model": "gemma4",
  "prompt": "Why is the sky blue?"
}'

라이브러리

Ollama는 Python과 JavaScript 공식 라이브러리를 제공해요. 그 외에도 커뮤니티가 유지 관리하는 라이브러리가 여럿 있는데, 전체 목록은 Ollama GitHub 저장소에서 볼 수 있어요.

버전 관리

Ollama API는 엄격하게 버전을 나누지는 않지만, 안정적이고 하위 호환이 유지되는 것을 기대해요. deprecation 은 드물고, 발생하면 릴리스 노트에서 안내돼요.

Ollama API 소개