Ollama API 인증

Ollama API 인증

로컬에서 Ollama를 쓸 때는 인증을 전혀 안 해도 돼요. 다만 ollama.com의 클라우드 모델을 쓰거나, 모델을 배포하거나, 비공개 모델을 내려받는 상황에서는 인증이 필요해요. 언제 인증이 필요한지부터 정리할게요.

출처: 공식문서 - Authentication

인증이 필요한 경우

  • ollama.com을 통해 클라우드 모델 실행
  • 모델 배포 (Publishing)
  • 비공개 모델 다운로드

이렇게 세 가지 경우에 인증을 요구해요. 로컬 http://localhost:11434로 접근할 땐 인증이 필요 없습니다.

인증 방법 두 가지

Ollama는 두 가지 인증 방식을 지원해요.

  • 로그인 (Signing in): 로컬 설치본에서 로그인하면, 명령 실행 시 ollama가 자동으로 ollama.com 요청을 인증해 줘요.
  • API 키 (API keys): ollama.com의 API를 프로그래밍 방식으로 호출할 때 쓰는 키예요.

로그인

로컬 Ollama에서 ollama.com에 로그인하려면 다음 명령을 실행해요.

ollama signin

로그인하면 Ollama가 필요한 명령을 자동으로 인증해 줘요. 예를 들어 클라우드 모델을 바로 run 할 수 있죠.

ollama run gpt-oss:120b-cloud

마찬가지로 클라우드 접근이 필요한 로컬 API 엔드포인트를 호출할 때도 Ollama가 요청을 자동으로 인증해요.

curl http://localhost:11434/api/generate -d '{
  "model": "gpt-oss:120b-cloud",
  "prompt": "Why is the sky blue?"
}'

API 키

https://ollama.com/api로 직접 접근하려면 API 키 인증이 필요해요. 먼저 API 키 설정에서 키를 만든 뒤, OLLAMA_API_KEY 환경 변수에 넣어요.

export OLLAMA_API_KEY=your_api_key

그리고 요청의 Authorization 헤더에 API 키를 실어 보내요.

curl https://ollama.com/api/generate \
  -H "Authorization: Bearer ***" \
  -d '{
    "model": "gpt-oss:120b",
    "prompt": "Why is the sky blue?",
    "stream": false
  }'

API 키는 현재 만료되지 않지만, API 키 설정에서 언제든지 폐기(revoke)할 수 있어요.

더 알아보기