로컬에서 http://localhost:11434를 통해 Ollama의 API에 접근할 때는 인증이 필요하지 않습니다.

다음의 경우 인증이 필요합니다:

• ollama.com을 통해 클라우드 모델 실행
• 모델 게시
• 비공개 모델 다운로드

Ollama는 두 가지 인증 방법을 지원합니다:

• 로그인: 로컬에 설치된 Ollama에서 로그인하면, 명령 실행 시 Ollama가 자동으로 ollama.com에 대한 요청 인증을 처리합니다
• API 키: ollama.com API에 프로그래밍 방식으로 접근하기 위한 API 키

로그인

로컬에 설치된 Ollama에서 ollama.com에 로그인하려면 다음 명령을 실행하세요:

ollama signin

로그인한 후에는 필요한 경우 Ollama가 명령을 자동으로 인증합니다:

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에서 제공되는 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 $OLLAMA_API_KEY" \
  -d '{
    "model": "gpt-oss:120b",
    "prompt": "Why is the sky blue?",
    "stream": false
  }'

API 키는 현재 만료되지 않지만, 언제든지 API 키 설정에서 취소할 수 있습니다.